Method: policies.list

Retrieves a list of the content owner's saved policies.

HTTP request

GET https://youtubepartner.googleapis.com/youtube/partner/v1/policies

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
id

string

The id parameter specifies a comma-separated list of saved policy IDs to retrieve. Only policies belonging to the currently authenticated content owner will be available.

onBehalfOfContentOwner

string

The onBehalfOfContentOwner parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.

sort

enum (Sort)

The sort parameter specifies how the search results should be sorted.

Request body

The request body must be empty.

Response body

A list of policies returned in response to a policies.list call.

If successful, the response body contains data with the following structure:

JSON representation
{
  "kind": string,
  "items": [
    {
      object (Policy)
    }
  ]
}
Fields
kind

string

The type of the API response. For this operation, the value is youtubePartner#policyList.

items[]

object (Policy)

A list of saved policies.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.

Sort

Supported sorting orders.

Enums
SORT_UNSPECIFIED Default value.
TIME_UPDATED_ASC Sort by the update time ascending.
TIME_UPDATED_DESC Sort by the update time descending.