REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

리소스: YoutubeAssetAssociation

리소스와 YouTube 애셋 간의 연결입니다.

JSON 표현 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
필드
name

string

식별자. 연결의 리소스 이름입니다.

광고 항목 수준 연결의 경우: 이름 패턴은 advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}입니다.

광고 그룹 수준 연결의 경우: 이름 패턴은 advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}입니다.

YOUTUBE_ASSET_TYPE_LOCATION 및 YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION 연결의 경우: youtubeAssetAssociationId는 연결된 애셋 세트의 ID입니다. locationMatchingType 또는 affiliateLocationMatchingType가 DISABLED인 경우 0입니다.

YOUTUBE_ASSET_TYPE_SITELINK 연결의 경우 youtubeAssetAssociationId은 연결된 사이트링크 확장 소재의 ID입니다.
youtubeAssetType

enum (YoutubeAssetType)

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

object (LinkedYouTubeAsset)

필수 항목입니다. 리소스와 연결된 YouTube 저작물입니다.

YoutubeAssetType

가능한 YouTube 애셋 유형입니다.

이러한 확장 소재는 게재 중에 광고와 함께 추가 정보를 표시합니다.

열거형
YOUTUBE_ASSET_TYPE_UNSPECIFIED 이 버전에서 YouTube 애셋 유형이 지정되지 않았거나 알 수 없습니다.
YOUTUBE_ASSET_TYPE_LOCATION 위치 확장 소재입니다.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION 제휴사 위치 확장 소재입니다.

LinkedYouTubeAsset

YoutubeAssetAssociation의 리소스에 연결된 YouTube 저작물입니다.

JSON 표현 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
필드
통합 필드 youtube_asset. YouTube 저작물입니다. youtube_asset은 다음 중 하나여야 합니다.
locationAssetFilter

object (LocationAssetFilter)

위치 확장 소재 필터입니다.

youtubeAssetType가 YOUTUBE_ASSET_TYPE_LOCATION인 경우에만 설정할 수 있습니다.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

제휴사 위치 확장 소재 필터입니다.

youtubeAssetType가 YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION인 경우에만 설정할 수 있습니다.

LocationAssetFilter

게재에 적합한 위치 애셋과 일치하는 애셋 필터입니다.

JSON 표현 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
필드
locationMatchingType

enum (LocationMatchingType)

필수 항목입니다. 이 위치 확장 소재 필터의 일치 유형입니다.
assetSetId

string (int64 format)

출력 전용입니다. 게재 가능한 위치 애셋과 일치하는 애셋 세트의 ID입니다.
locationMatchingFunction

object (LocationMatchingFunction)

선택사항입니다. 위치 확장 소재 필터가 위치 확장 소재와 일치하는 방식을 지정하는 일치 함수입니다.

이 필드는 필수이며 locationMatchingType가 FILTER 또는 SELECTED_ASSETS인 경우에만 설정할 수 있습니다.

LocationMatchingType

게재 가능한 위치 애셋을 결정하는 일치 유형입니다.

열거형
LOCATION_MATCHING_TYPE_UNSPECIFIED 이 버전에서는 위치 일치 유형이 지정되지 않았거나 알 수 없습니다.
SELECT_ALL 사용 가능한 모든 위치 확장 소재는 게재될 수 있습니다.
FILTER 제공된 업체 이름 및/또는 라벨 필터와 일치하는 위치 애셋이 게재될 수 있습니다.
SELECTED_ASSETS 선택한 위치 확장 소재만 게재될 수 있습니다.
DISABLED 위치 확장 소재가 게재될 수 없습니다.

LocationMatchingFunction

위치 확장 소재 필터의 일치 함수입니다.

JSON 표현 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
필드
labels[]

string

선택사항입니다. 일치시킬 라벨입니다.

라벨은 논리적으로 OR됩니다.

이 필드는 선택사항이며 locationMatchingType이 FILTER인 경우에만 설정할 수 있습니다.
locationAssetIds[]

string (int64 format)

선택사항입니다. 선택된 위치 확장 소재 ID입니다.

locationMatchingType이 SELECTED_ASSETS인 경우 이 필드는 필수입니다.
business

string

선택사항입니다. 일치시킬 비즈니스 이름입니다.

이 필드는 선택사항이며 locationMatchingType이 FILTER인 경우에만 설정할 수 있습니다.

AffiliateLocationAssetFilter

게재에 적합한 제휴사 위치 확장 소재와 일치하는 확장 소재 필터입니다.

JSON 표현 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
필드
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

필수 항목입니다. 이 제휴사 위치 확장 소재 필터의 일치 유형입니다.
assetSetId

string (int64 format)

출력 전용입니다. 게재 가능한 제휴사 위치 확장 소재와 일치하는 애셋 세트의 ID입니다.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

선택사항입니다. 제휴사 위치 확장 소재 필터가 제휴사 위치 확장 소재와 일치하는 방식을 나타내는 일치 함수입니다.

이 필드는 필수이며 affiliateLocationMatchingType가 SELECTED_CHAINS인 경우에만 설정할 수 있습니다.

AffiliateLocationMatchingType

게재 가능한 제휴사 위치 확장 소재를 결정하는 일치 유형입니다.

열거형
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED 이 버전에서는 제휴사 위치 일치 유형이 지정되지 않았거나 알 수 없습니다.
SELECT_ALL 사용 가능한 모든 제휴사 위치 확장 소재는 게재될 수 있습니다.
SELECTED_CHAINS 선택한 제휴사 위치 확장 소재가 게재될 수 있습니다.
DISABLED 제휴사 위치 확장 소재가 게재될 수 없습니다.

AffiliateLocationMatchingFunction

제휴사 위치 확장 소재 필터의 일치 함수입니다.

JSON 표현 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
필드
chains[]

object (AffiliateLocationChain)

선택사항입니다. 선택된 제휴사 위치 체인 ID입니다.

affiliateLocationMatchingType이 SELECTED_CHAINS인 경우 이 필드는 필수입니다.

AffiliateLocationChain

제휴사 위치 체인입니다.

JSON 표현 
{
  "chainId": string
}
필드
chainId

string (int64 format)

필수 항목입니다. 제휴사 위치 체인의 ID입니다.

SitelinkAsset

사이트링크 확장 소재입니다.

JSON 표현 
{
  "assetId": string
}
필드
assetId

string (int64 format)

필수 항목입니다. 사이트링크 확장 소재의 ID입니다.

메서드

create

 식별된 리소스와 YouTube 애셋 간의 새 연결을 만듭니다.

delete

 식별된 리소스와 YouTube 애셋 간의 기존 연결을 삭제합니다.

list

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