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 สถานที่ตั้งระดับการซิงค์ที่องค์ประกอบใน AssetSet ของ LocationGroup มาจาก ต้องกรอกฟิลด์นี้และใช้ได้กับ 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 และแหล่งที่มาของการซิงค์คือ Chain

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 ตัวกรองประเภทต่างๆ จะใช้ตรรกะ AND ร่วมกัน หากมีการระบุ

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

listingIdFilters[]

string (int64 format)

ใช้เพื่อกรองข้อมูล Google Business Profile ตามรหัสข้อมูล หากมีรายการใน listingIdFilters จะมีเฉพาะข้อมูลผลิตภัณฑ์ที่ระบุโดยตัวกรองเท่านั้นที่จะซิงค์กับชิ้นงานได้ หากไม่มีรายการใน listingIdFilters แสดงว่าข้อมูลทั้งหมดมีสิทธิ์ซิงค์ ตัวกรองรหัสข้อมูลใช้ OR ร่วมกัน

businessAccountId

string

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

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 ในชุดชิ้นงาน หากระบุตัวกรองหลายรายการ ระบบจะใช้ตรรกะ AND ร่วมกัน

การแสดง 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 และแหล่งที่มาของการซิงค์คือ Chain

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

object (ChainFilter)

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