Method: assetShares.list
Stay organized with collections
Save and categorize content based on your preferences.
This method either retrieves a list of asset shares the partner owns and that map to a specified asset view ID or
it retrieves a list of asset views associated with a specified asset share ID owned by the partner.
HTTP request
GET https://youtubepartner.googleapis.com/youtube/partner/v1/assetShares
The URL uses gRPC Transcoding
syntax.
Query parameters
assetId
string
The assetId
parameter specifies the asset ID for which you are retrieving data. The parameter can be an asset view ID or an asset share ID.
- If the value is an asset view ID, the API response identifies any asset share ids mapped to the asset view.
- If the value is an asset share ID, the API response identifies any asset view ids that maps to that asset share.
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.
pageToken
string
The pageToken
parameter specifies a token that identifies a particular page of results to return. Set this parameter to the value of the nextPageToken
value from the previous API response to retrieve the next page of search results.
Request body
The request body must be empty.
Response body
A paginated list of assetShare
resources returned in response to a list
request.
If successful, the response body contains data with the following structure:
| Fields |
kind
|
string
The type of the API response. For this operation, the value is youtubePartner#assetShareList
.
|
pageInfo
|
object ( PageInfo
)
The pageInfo
object encapsulates paging information for the result set.
|
items[]
|
object ( AssetShare
)
An assetShare
resource that matches the request criteria.
|
nextPageToken
|
string
The token that can be used as the value of the pageToken
parameter to retrieve the next page of results.
|
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview
.
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\u003eThis API method retrieves either a list of asset shares mapped to a specified asset view ID or a list of asset views associated with a specified asset share ID.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eassetId\u003c/code\u003e query parameter is used to specify either an asset view ID or an asset share ID to retrieve the corresponding data.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e query parameter allows users to specify the content owner they are acting on behalf of, which is useful for users with accounts linked to multiple content owners.\u003c/p\u003e\n"],["\u003cp\u003eThe response body is a paginated list of \u003ccode\u003eassetShare\u003c/code\u003e resources, structured with fields like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003epageInfo\u003c/code\u003e, \u003ccode\u003eitems\u003c/code\u003e, and \u003ccode\u003enextPageToken\u003c/code\u003e for navigating results.\u003c/p\u003e\n"],["\u003cp\u003eAn authorization scope of \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e is required to make requests to this API.\u003c/p\u003e\n"]]],["This API method uses a `GET` request to retrieve asset shares or asset views. It requires an empty request body. The `assetId` parameter in the query specifies either an asset view ID to find associated asset share IDs, or an asset share ID to find associated asset view IDs. The `onBehalfOfContentOwner` parameter is used to specify the content owner. The response, structured as `assetShareList`, includes `kind`, `pageInfo`, `items` and a `nextPageToken` for pagination. It uses the `youtubepartner` scope.\n"],null,["# Method: assetShares.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AssetShareListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nThis method either retrieves a list of asset shares the partner owns and that map to a specified asset view ID *or* it retrieves a list of asset views associated with a specified asset share ID owned by the partner.\n\n### HTTP request\n\n`GET https://youtubepartner.googleapis.com/youtube/partner/v1/assetShares`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `assetId` | `string` The `assetId` parameter specifies the asset ID for which you are retrieving data. The parameter can be an asset view ID or an asset share ID. - If the value is an asset view ID, the API response identifies any asset share ids mapped to the asset view. - If the value is an asset share ID, the API response identifies any asset view ids that maps to that asset share. \u003cbr /\u003e |\n| `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. |\n| `pageToken` | `string` The `pageToken` parameter specifies a token that identifies a particular page of results to return. Set this parameter to the value of the `nextPageToken` value from the previous API response to retrieve the next page of search results. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA paginated list of `assetShare` resources returned in response to a `list` request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"pageInfo\": { object (/youtube/partner/reference/rest/v1/PageInfo) }, \"items\": [ { object (/youtube/partner/reference/rest/v1/assetShares#AssetShare) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API response. For this operation, the value is `youtubePartner#assetShareList`. |\n| `pageInfo` | `object (`[PageInfo](/youtube/partner/reference/rest/v1/PageInfo)`)` The `pageInfo` object encapsulates paging information for the result set. |\n| `items[]` | `object (`[AssetShare](/youtube/partner/reference/rest/v1/assetShares#AssetShare)`)` An `assetShare` resource that matches the request criteria. |\n| `nextPageToken` | `string` The token that can be used as the value of the `pageToken` parameter to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/youtubepartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
