AssetSet

ชุดชิ้นงานที่แสดงถึงคอลเล็กชันเนื้อหา ใช้ AssetSetAsset เพื่อลิงก์ชิ้นงานกับชุดชิ้นงาน

การแสดง JSON
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
ช่อง
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของชุดเนื้อหา

resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของชุดเนื้อหา ชื่อทรัพยากรของชุดชิ้นงานมีรูปแบบดังนี้

customers/{customerId}/assetSets/{asset_set_id}

name

string

ต้องระบุ ชื่อของชุดเนื้อหา ต้องระบุ โดยต้องมีความยาวขั้นต่ำ 1 และความยาวสูงสุด 128

type

enum (AssetSetType)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทของชุดชิ้นงาน ต้องระบุ

status

enum (AssetSetStatus)

เอาต์พุตเท่านั้น สถานะของชุดเนื้อหา อ่านอย่างเดียว

merchantCenterFeed

object (MerchantCenterFeed)

รหัสผู้ขายและป้ายกำกับฟีดจาก Google Merchant Center

locationGroupParentAssetSetId

string (int64 format)

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

hotelPropertyData

object (HotelPropertyData)

เอาต์พุตเท่านั้น สําหรับแคมเปญ Performance Max สำหรับเป้าหมายการท่องเที่ยวที่มีการลิงก์บัญชี Hotel Center อ่านอย่างเดียว

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

object (LocationSet)

ข้อมูลชุดชิ้นงานสถานที่ตั้ง นี้จะใช้สำหรับการตั้งค่าระดับการซิงค์ ตั้งค่านี้ได้หากประเภทของ AssetSet คือ LOCATION_SYNC

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

ข้อมูลชุดชิ้นงานของกลุ่มสถานที่ตั้ง Business Profile

chainLocationGroup

object (ChainLocationGroup)

แสดงข้อมูลเกี่ยวกับกลุ่มสถานที่ตั้งแบบไดนามิกของเชน ใช้ได้เฉพาะในกรณีที่ประเภทของ AssetSet ระดับการซิงค์คือ LOCATION_SYNC และแหล่งที่มาการซิงค์เป็นเชน

AssetSetStatus

สถานะที่เป็นไปได้ของชุดชิ้นงาน

Enum
UNSPECIFIED ไม่ได้ระบุสถานะ
UNKNOWN ไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้ นี่คือค่าการตอบกลับเท่านั้น
ENABLED เปิดใช้ชุดชิ้นงานแล้ว
REMOVED นำชุดชิ้นงานออกแล้ว

MerchantCenterFeed

รหัสผู้ขายและป้ายกำกับฟีดจาก Google Merchant Center

การแสดง JSON
{
  "merchantId": string,
  "feedLabel": string
}
ช่อง
merchantId

string (int64 format)

ต้องระบุ รหัสผู้ขายจาก Google Merchant Center

feedLabel

string

ไม่บังคับ ป้ายกำกับฟีดจาก Google Merchant Center

HotelPropertyData

สําหรับแคมเปญ Performance Max สำหรับเป้าหมายการท่องเที่ยวที่มีการลิงก์บัญชี Hotel Center อ่านอย่างเดียว

การแสดง JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
ช่อง
hotelCenterId

string (int64 format)

เอาต์พุตเท่านั้น รหัส Hotel Center ของพาร์ทเนอร์

partnerName

string

เอาต์พุตเท่านั้น ชื่อพาร์ทเนอร์โรงแรม

LocationSet

ข้อมูลที่เกี่ยวข้องกับกลุ่มสถานที่ ต้องระบุข้อมูล Google Business Profile (เดิมเรียกว่า Google My Business) ข้อมูลเชน และข้อมูลตำแหน่งในแผนที่

การแสดง JSON
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
ช่อง
locationOwnershipType

enum (LocationOwnershipType)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทการเป็นเจ้าของสถานที่ตั้ง (สถานที่ตั้งที่คุณเป็นเจ้าของหรือสถานที่ตั้งของแอฟฟิลิเอต)

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

object (BusinessProfileLocationSet)

ข้อมูลที่ใช้กำหนดค่าชุดสถานที่ซึ่งมาจากสถานที่ตั้งใน Google Business Profile

chainLocationSet

object (ChainSet)

ข้อมูลที่ใช้กําหนดค่าตําแหน่งในชุดเชนซึ่งมีการเติมข้อมูลด้วยเชนที่ระบุ

mapsLocationSet

object (MapsLocationSet)

ตั้งค่าเฉพาะในกรณีที่มีการซิงค์สถานที่โดยอิงตามสถานที่ในแผนที่ที่เลือกเท่านั้น

BusinessProfileLocationSet

ข้อมูลที่ใช้กำหนดค่าชุดสถานที่ซึ่งมาจากสถานที่ตั้งใน Google Business Profile ตัวกรองประเภทต่างๆ จะใช้ "และ" ร่วมกัน (หากระบุไว้)

การแสดง JSON
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
ช่อง
httpAuthorizationToken

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ โทเค็นการให้สิทธิ์ HTTP ที่ใช้เพื่อรับการให้สิทธิ์

emailAddress

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ อีเมลของบัญชี Google Business Profile หรืออีเมลของผู้จัดการของบัญชี Google Business Profile

businessNameFilter

string

ใช้เพื่อกรองข้อมูล Google Business Profile ตามชื่อธุรกิจ หากตั้งค่า businessNameFilter ไว้ เฉพาะรายชื่อที่มีชื่อธุรกิจที่ตรงกันเท่านั้นที่เป็นตัวเลือกที่จะซิงค์ไปยังชิ้นงาน

labelFilters[]

string

ใช้สำหรับกรองข้อมูล Google Business Profile ตามป้ายกำกับ หากมีรายการอยู่ในตัวกรองป้ายกำกับ เฉพาะรายชื่อที่มีป้ายกำกับที่ตั้งค่าเท่านั้นที่สามารถซิงค์กับเนื้อหาได้ หากไม่มีรายการอยู่ในตัวกรองป้ายกำกับ ข้อมูลทั้งหมดก็เป็นตัวเลือกสำหรับการซิงค์ ตัวกรองป้ายกำกับจะใช้ OR ร่วมกัน

listingIdFilters[]

string (int64 format)

ใช้เพื่อกรองข้อมูล Google Business Profile ตามรหัสข้อมูล หากมีรายการอยู่ใน listingIdFilter เฉพาะรายชื่อที่ตัวกรองระบุไว้เท่านั้นที่เป็นตัวเลือกที่จะซิงค์กับชิ้นงาน หากไม่มีรายการอยู่ใน listingIdFilter รายชื่อทั้งหมดก็เป็นตัวเลือกสำหรับการซิงค์ ตัวกรองรหัสรายชื่ออยู่ร่วมกัน

businessAccountId

string

เปลี่ยนแปลงไม่ได้ รหัสบัญชีของธุรกิจที่มีการจัดการซึ่งจะใช้สถานที่ตั้ง หากไม่ได้ตั้งค่าช่องนี้ ระบบจะใช้ธุรกิจทั้งหมดที่ผู้ใช้เข้าถึงได้ (ระบุโดยอีเมล)

ChainSet

ข้อมูลที่ใช้กําหนดค่าชุดสถานที่ตั้งที่มีการเติมข้อมูลเชนที่ระบุ

การแสดง JSON
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
ช่อง
relationshipType

enum (ChainRelationshipType)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทความสัมพันธ์ที่เครือธุรกิจที่ระบุมีกับผู้ลงโฆษณารายนี้

chains[]

object (ChainFilter)

ต้องระบุ รายการตัวกรองระดับเชน ตัวกรองทั้งหมดจะใช้ OR ร่วมกัน

ChainRelationshipType

ประเภทความสัมพันธ์ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับผลลัพธ์เท่านั้น แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
AUTO_DEALERS ความสัมพันธ์กับตัวแทนจำหน่ายรถยนต์
GENERAL_RETAILERS ความสัมพันธ์กับผู้ค้าปลีกทั่วไป

ChainFilter

ตัวกรองระดับเชน 1 รายการสำหรับสถานที่ตั้งในชุดรายการฟีด ตรรกะการกรองในฟิลด์ทั้งหมดคือ AND

การแสดง JSON
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
ช่อง
chainId

string (int64 format)

ต้องระบุ ใช้เพื่อกรองสถานที่ตั้งของเชนตามรหัสเชน เฉพาะสถานที่ตั้งของเชนซึ่งเป็นของเชนที่ระบุเท่านั้นที่จะอยู่ในชุดชิ้นงาน

locationAttributes[]

string

ใช้เพื่อกรองสถานที่ตั้งของเชนตามแอตทริบิวต์สถานที่ตั้ง เฉพาะสถานที่ตั้งของเชนที่อยู่ในแอตทริบิวต์ที่ระบุทั้งหมดเท่านั้นที่จะอยู่ในชุดชิ้นงาน หากช่องนี้ว่างเปล่า หมายความว่าไม่มีการกรองในช่องนี้

MapsLocationSet

Wrapper สำหรับข้อมูลการซิงค์ตำแหน่งหลายแผนที่

การแสดง JSON
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
ช่อง
mapsLocations[]

object (MapsLocationInfo)

ต้องระบุ รายการข้อมูลตำแหน่งในแผนที่ที่ผู้ใช้ซิงค์ด้วยตนเอง

MapsLocationInfo

Wrapper สำหรับรหัสสถานที่

การแสดง JSON
{
  "placeId": string
}
ช่อง
placeId

string

รหัสสถานที่ของสถานที่ตั้งใน Maps

BusinessProfileLocationGroup

ข้อมูลเกี่ยวกับกลุ่มสถานที่ตั้งแบบไดนามิกของ Business Profile มีผลเฉพาะในกรณีที่ประเภท AssetSet ระดับการซิงค์คือ LOCATION_SYNC และแหล่งที่มาการซิงค์คือ Business Profile

การแสดง JSON
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
ช่อง
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

กรองชุดสถานที่ตั้ง Business Profile แบบไดนามิก

DynamicBusinessProfileLocationGroupFilter

แสดงตัวกรองสถานที่ตั้ง Business Profile ในชุดชิ้นงาน หากมีตัวกรองหลายรายการ ตัวกรองเหล่านั้นจะถูกรวมเข้าด้วยกัน

การแสดง JSON
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
ช่อง
labelFilters[]

string

ใช้เพื่อกรองสถานที่ตั้ง Business Profile ตามป้ายกำกับ เฉพาะสถานที่ตั้งที่มีป้ายกำกับที่แสดงเท่านั้นที่จะอยู่ในชุดเนื้อหา ตัวกรองป้ายกำกับจะใช้ OR ร่วมกัน

listingIdFilters[]

string (int64 format)

ใช้เพื่อกรองสถานที่ตั้ง Business Profile ตามรหัสรายชื่อ

businessNameFilter

object (BusinessProfileBusinessNameFilter)

ใช้เพื่อกรองสถานที่ตั้ง Business Profile ตามชื่อธุรกิจ

BusinessProfileBusinessNameFilter

ตัวกรองชื่อธุรกิจของกลุ่มสถานที่ตั้ง Business Profile

การแสดง JSON
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
ช่อง
businessName

string

สตริงชื่อธุรกิจที่จะใช้สำหรับการกรอง

filterType

enum (LocationStringFilterType)

ประเภทของการจับคู่สตริงที่จะใช้เมื่อกรองกับ businessName

LocationStringFilterType

ประเภทตัวกรองสตริงตำแหน่งที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับผลลัพธ์เท่านั้น แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
EXACT ตัวกรองจะใช้การจับคู่สตริงที่ตรงกันทั้งหมด

ChainLocationGroup

แสดงข้อมูลเกี่ยวกับกลุ่มสถานที่ตั้งแบบไดนามิกของเชน ใช้ได้เฉพาะในกรณีที่ประเภทของ AssetSet ระดับการซิงค์คือ LOCATION_SYNC และแหล่งที่มาการซิงค์เป็นเชน

การแสดง JSON
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
ช่อง
dynamicChainLocationGroupFilters[]

object (ChainFilter)

ใช้เพื่อกรองสถานที่ตั้งของเชนตามรหัสเชน เฉพาะสถานที่ตั้งที่เป็นของเชนที่ระบุเท่านั้นที่จะอยู่ในชุดชิ้นงาน