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 ตามป้ายกำกับ หากมีรายการอยู่ในตัวกรองป้ายกำกับ เฉพาะข้อมูลที่มีป้ายกำกับที่กำหนดเท่านั้นที่จะมีสิทธิ์ซิงค์กับเนื้อหา หากไม่มีรายการอยู่ในตัวกรองป้ายกำกับ หมายความว่าข้อมูลทั้งหมดเป็นตัวเลือกสำหรับการซิงค์ ตัวกรองป้ายกำกับจะใช้ "หรือ" ร่วมกัน

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)

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

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 ตามป้ายกำกับ เฉพาะสถานที่ตั้งที่มีป้ายกำกับที่แสดงเท่านั้นที่จะอยู่ในชุดเนื้อหา ตัวกรองป้ายกำกับจะใช้ "หรือ" ร่วมกัน

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)

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