REST Resource: policies
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Policy
A policy
resource specifies rules that define a particular usage or match policy that a partner can associate with an asset or claim.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eA \u003ccode\u003epolicy\u003c/code\u003e resource defines usage or match rules that partners can apply to assets or claims.\u003c/p\u003e\n"],["\u003cp\u003ePolicies contain rules that dictate YouTube's actions under specific conditions, impacting asset management.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage policies using a comprehensive set of methods including retrieval, creation, listing, patching, and updating.\u003c/p\u003e\n"],["\u003cp\u003eEach policy is uniquely identifiable via an assigned \u003ccode\u003eid\u003c/code\u003e and includes key descriptive properties like name and description.\u003c/p\u003e\n"]]],["A `policy` resource defines usage or match rules for assets or claims. It includes a name, description, update timestamp, and a list of `rules` specifying YouTube's actions and conditions. Each policy has a unique `id`. The JSON representation includes these fields. Available methods include `get` to retrieve a policy, `insert` to create one, `list` to view multiple, `patch` for partial updates, and `update` to modify a policy.\n"],null,["# REST Resource: policies\n\n- [Resource: Policy](#Policy)\n - [JSON representation](#Policy.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Policy\n----------------\n\nA `policy` resource specifies rules that define a particular usage or match policy that a partner can associate with an asset or claim.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"name\": string, \"description\": string, \"timeUpdated\": string, \"rules\": [ { object (/youtube/partner/reference/rest/v1/PolicyRule) } ], \"id\": string } ``` |\n\n| Fields ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies this as a policy. Value: \"`youtubePartner#policy`\" |\n| `name` | `string` The policy's name. |\n| `description` | `string` The policy's description. |\n| `timeUpdated` | `string` The time the policy was updated. |\n| `rules[]` | `object (`[PolicyRule](/youtube/partner/reference/rest/v1/PolicyRule)`)` A list of rules that specify the action that YouTube should take and may optionally specify the conditions under which that action is enforced. |\n| `id` | `string` A value that YouTube assigns and uses to uniquely identify the policy. |\n\n| Methods ------- ||\n|------------------------------------------------------------------|---------------------------------------------------------|\n| ### [get](/youtube/partner/reference/rest/v1/policies/get) | Retrieves the specified saved policy. |\n| ### [insert](/youtube/partner/reference/rest/v1/policies/insert) | Creates a saved policy. |\n| ### [list](/youtube/partner/reference/rest/v1/policies/list) | Retrieves a list of the content owner's saved policies. |\n| ### [patch](/youtube/partner/reference/rest/v1/policies/patch) | Patches the specified saved policy. |\n| ### [update](/youtube/partner/reference/rest/v1/policies/update) | Updates the specified saved policy. |"]]
