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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
ช่อง
เนื้อหา YouTube ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
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 ที่ลิงก์กับทรัพยากรที่ระบุ