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 คือรหัสของชุดชิ้นงานที่ลิงก์ หรือ 0 หาก locationMatchingType หรือ affiliateLocationMatchingType เป็น DISABLED

สำหรับYOUTUBE_ASSET_TYPE_SITELINKการเชื่อมโยง: youtubeAssetAssociationId คือรหัสของชิ้นงานไซต์ลิงก์ที่ลิงก์ไว้
youtubeAssetType

enum (YoutubeAssetType)

ต้องระบุ ประเภทของเนื้อหา YouTube ที่เชื่อมโยงกับแหล่งข้อมูล
linkedYoutubeAsset

object (LinkedYouTubeAsset)

ต้องระบุ เนื้อหา YouTube ที่เชื่อมโยงกับแหล่งข้อมูล

YoutubeAssetType

ประเภทของเนื้อหา YouTube ที่เป็นไปได้

ชิ้นงานเหล่านี้จะแสดงข้อมูลเพิ่มเติมควบคู่ไปกับโฆษณาระหว่างการแสดง

Enum
YOUTUBE_ASSET_TYPE_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบประเภทชิ้นงาน YouTube ในเวอร์ชันนี้
YOUTUBE_ASSET_TYPE_LOCATION ชิ้นงานสถานที่ตั้ง
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION ชิ้นงานสถานที่ตั้งของแอฟฟิลิเอต

LinkedYouTubeAsset

เนื้อหา YouTube ที่ลิงก์กับแหล่งข้อมูลใน YoutubeAssetAssociation

การแสดง 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.
}
ช่อง
ฟิลด์ Union 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)

เอาต์พุตเท่านั้น รหัสของชุดชิ้นงานที่ตรงกับชิ้นงานสถานที่ที่มีสิทธิ์แสดง
locationMatchingFunction

object (LocationMatchingFunction)

ไม่บังคับ ฟังก์ชันการจับคู่ที่กำหนดวิธีที่ตัวกรองชิ้นงานสถานที่ตั้งจับคู่ชิ้นงานสถานที่ตั้ง

ต้องระบุข้อมูลในช่องนี้ และจะตั้งค่าได้ก็ต่อเมื่อ locationMatchingType เป็น FILTER หรือ SELECTED_ASSETS เท่านั้น

LocationMatchingType

ประเภทการจับคู่ที่เป็นไปได้ซึ่งกำหนดว่าชิ้นงานตำแหน่งใดมีสิทธิ์แสดง

Enum
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)

ไม่บังคับ รหัสชิ้นงานสถานที่ตั้งที่เลือก

ต้องระบุข้อมูลในช่องนี้หาก locationMatchingType เป็น SELECTED_ASSETS
business

string

ไม่บังคับ ชื่อธุรกิจที่จะใช้จับคู่

ช่องนี้ไม่บังคับ และจะตั้งค่าได้ก็ต่อเมื่อ locationMatchingType เป็น FILTER เท่านั้น

AffiliateLocationAssetFilter

ตัวกรองชิ้นงานที่ตรงกับชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตที่มีสิทธิ์สำหรับการแสดง

การแสดง JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
ฟิลด์
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

ต้องระบุ ประเภทการจับคู่ของตัวกรองชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตนี้
assetSetId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของชุดชิ้นงานที่ตรงกับชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตที่มีสิทธิ์แสดง
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

ไม่บังคับ ฟังก์ชันการจับคู่ที่กำหนดวิธีที่ตัวกรองชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตจะจับคู่กับชิ้นงานสถานที่ตั้งของแอฟฟิลิเอต

ต้องระบุข้อมูลในช่องนี้ และจะตั้งค่าได้ก็ต่อเมื่อ affiliateLocationMatchingType เป็น SELECTED_CHAINS เท่านั้น

AffiliateLocationMatchingType

ประเภทการจับคู่ที่เป็นไปได้ซึ่งจะกำหนดว่าชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตใดมีสิทธิ์แสดง

Enum
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบประเภทการจับคู่สถานที่ตั้งของแอฟฟิลิเอตในเวอร์ชันนี้
SELECT_ALL ชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตทั้งหมดที่พร้อมใช้งานจะมีสิทธิ์แสดง
SELECTED_CHAINS ชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตที่เลือกจะแสดงได้
DISABLED แสดงชิ้นงานสถานที่ตั้งของแอฟฟิลิเอตไม่ได้

AffiliateLocationMatchingFunction

ฟังก์ชันการจับคู่สำหรับตัวกรองชิ้นงานสถานที่ตั้งของแอฟฟิลิเอต

การแสดง JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
ฟิลด์
chains[]

object (AffiliateLocationChain)

ไม่บังคับ รหัสเชนของสถานที่ตั้งของแอฟฟิลิเอตที่เลือก

ต้องระบุข้อมูลในช่องนี้หาก affiliateLocationMatchingType เป็น SELECTED_CHAINS

AffiliateLocationChain

เชนของสถานที่ตั้งของแอฟฟิลิเอต

การแสดง JSON 
{
  "chainId": string
}
ฟิลด์
chainId

string (int64 format)

ต้องระบุ รหัสของเชนสถานที่ตั้งของแอฟฟิลิเอต

SitelinkAsset

ชิ้นงานไซต์ลิงก์

การแสดง JSON 
{
  "assetId": string
}
ฟิลด์
assetId

string (int64 format)

ต้องระบุ รหัสของชิ้นงานไซต์ลิงก์

เมธอด

create

 สร้างการเชื่อมโยงใหม่ระหว่างแหล่งข้อมูลที่ระบุกับเนื้อหา YouTube

delete

 ลบการเชื่อมโยงที่มีอยู่ระหว่างทรัพยากรที่ระบุและเนื้อหา YouTube

list

 แสดงรายการการเชื่อมโยงเนื้อหา YouTube ที่ลิงก์กับแหล่งข้อมูลที่ระบุ