Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

지정된 리소스에 연결된 YouTube 저작물 연결을 나열합니다.

HTTP 요청

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 연결된 항목이 속한 광고주의 ID입니다.
통합 파라미터 entity. YouTube 저작물과 연결할 항목입니다. entity은 다음 중 하나여야 합니다.
linkedEntity.lineItemId

string (int64 format)

품목의 ID입니다.
youtubeAssetType

enum (YoutubeAssetType)

필수 항목입니다. 리소스와 연결되는 YouTube 저작물의 유형입니다.

쿼리 매개변수

매개변수
통합 파라미터 entity. YouTube 저작물과 연결할 항목입니다. entity은 다음 중 하나여야 합니다.
linkedEntity.adGroupId

string (int64 format)

광고 그룹의 ID입니다.
pageSize

integer

선택사항입니다. 요청한 페이지 크기입니다. 1에서 10000 사이여야 합니다. 지정하지 않으면 기본값은 100입니다. 잘못된 값이 지정되면 오류 코드 INVALID_ARGUMENT를 반환합니다.
pageToken

string

선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.

일반적으로 이는 youtubeAssetAssociations.list 메서드에 대한 이전 호출에서 반환된 nextPageToken 값입니다. 지정하지 않으면 결과의 첫 번째 페이지가 반환됩니다.
orderBy

string

선택사항입니다. 목록을 정렬할 필드입니다.

허용되는 값은 다음과 같습니다.

  • linkedYoutubeAsset.locationAssetFilter.assetSetId
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId
  • linkedYoutubeAsset.sitelinkAsset.assetId

기본 정렬 순서는 오름차순입니다. 필드에서 내림차순으로 지정하려면 서픽스 'desc'를 필드 이름에 추가해야 합니다. 예: linkedYoutubeAsset.sitelinkAsset.assetId desc

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 ListYoutubeAssetAssociationsResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/display-video

자세한 내용은 OAuth 2.0 Overview를 참고하세요.