Feed

ฟีด

การแสดง JSON 
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
ช่อง
resourceName

string

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

customers/{customerId}/feeds/{feedId}
attributes[]

object (FeedAttribute)

แอตทริบิวต์ของฟีด ต้องระบุใน CREATE เว้นแต่จะระบุ system_feed_generation_data ในกรณีนี้ Google Ads จะอัปเดตฟีดด้วยแอตทริบิวต์ที่ถูกต้อง ไม่อนุญาตใน UPDATE ใช้แอตทริบิวต์การดำเนินการเพื่อเพิ่มแอตทริบิวต์ใหม่
attributeOperations[]

object (FeedAttributeOperation)

รายการการดำเนินการที่เปลี่ยนแปลงแอตทริบิวต์ฟีด คุณเพิ่มแอตทริบิวต์ได้อย่างเดียว นำออกไม่ได้
origin

enum (FeedOrigin)

เปลี่ยนแปลงไม่ได้ ระบุผู้ที่จัดการ FeedAttributes ของฟีด
status

enum (FeedStatus)

เอาต์พุตเท่านั้น สถานะของฟีด ช่องนี้เป็นแบบอ่านอย่างเดียว
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของฟีด ช่องนี้เป็นแบบอ่านอย่างเดียว
name

string

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

object (PlacesLocationFeedData)

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

object (AffiliateLocationFeedData)

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

FeedAttribute

FeedAttributes กำหนดประเภทของข้อมูลที่จะแสดงในฟีด FeedAttribute รายการเดียวจะระบุประเภท FeedItemAttributes ที่คาดไว้ซึ่งมี FeedAttributeId เดียวกัน หรือจะทำเครื่องหมาย FeedAttribute ให้เป็นส่วนหนึ่งของคีย์ที่ไม่ซ้ำกันของ FeedItem ก็ได้

การแสดง JSON 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
ช่อง
type

enum (FeedAttributeType)

ประเภทข้อมูลสำหรับแอตทริบิวต์ฟีด ต้องระบุ
id

string (int64 format)

รหัสของแอตทริบิวต์
name

string

ชื่อของแอตทริบิวต์ ต้องระบุ
isPartOfKey

boolean

ระบุว่าข้อมูลที่เกี่ยวข้องกับแอตทริบิวต์นี้เป็นส่วนหนึ่งของคีย์ที่ไม่ซ้ำกันของ FeedItem ซึ่งจะมีค่าเริ่มต้นเป็น "เท็จ" หากไม่ได้ระบุ โปรดทราบว่าสคีมาของฟีดไม่จำเป็นต้องมีคีย์ที่ไม่ซ้ำกัน ซึ่งในกรณีนี้ฟีดต้องอ้างอิงโดย feed_item_id ของรายการ

FeedAttributeType

ประเภทข้อมูลที่เป็นไปได้สำหรับแอตทริบิวต์ฟีด

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
INT64 Int64
DOUBLE คู่
STRING สตริง
BOOLEAN บูลีน
URL URL
DATE_TIME วันที่และเวลา
INT64_LIST รายการ Int64
DOUBLE_LIST รายการแบบคู่ (8 ไบต์)
STRING_LIST รายการสตริง
BOOLEAN_LIST รายการบูลีน
URL_LIST รายการ URL
DATE_TIME_LIST รายการวันที่และเวลา
PRICE ราคา

FeedAttributeOperation

การดำเนินการที่จะทำในรายการแอตทริบิวต์ฟีดในการเปลี่ยนแปลง

การแสดง JSON 
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
ช่อง
operator

enum (Operator)

เอาต์พุตเท่านั้น ประเภทการดำเนินการของรายการที่จะดำเนินการ
value

object (FeedAttribute)

เอาต์พุตเท่านั้น แอตทริบิวต์ฟีดที่เพิ่มในรายการ

ผู้ประกอบธุรกิจ

โอเปอเรเตอร์

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

FeedOrigin

ค่าที่เป็นไปได้สำหรับต้นทางฟีด

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
USER แอตทริบิวต์ Feed สำหรับฟีดนี้ได้รับการจัดการโดยผู้ใช้ ผู้ใช้จะเพิ่มแอตทริบิวต์ Feed ลงในฟีดนี้ได้
GOOGLE แอตทริบิวต์ FeedAttributes สำหรับฟีดของ GOOGLE สร้างขึ้นโดย Google ฟีดประเภทนี้ได้รับการดูแลโดย Google และจะมีแอตทริบิวต์ที่ถูกต้องสำหรับประเภทตัวยึดตำแหน่งของฟีด

FeedStatus

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

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

PlacesLocationFeedData

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

การแสดง JSON 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
ช่อง
oauthInfo

object (OAuthInfo)

เปลี่ยนแปลงไม่ได้ โทเค็นการตรวจสอบสิทธิ์ที่จำเป็น (จาก OAuth API) สำหรับอีเมล ฟิลด์นี้สามารถระบุในคำขอสร้างเท่านั้น เลือกช่องย่อยทั้งหมดไม่ได้
businessAccountId

string

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

string

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

string

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

string

อีเมลของ Business Profile หรืออีเมลของผู้จัดการ Business Profile ต้องระบุ
businessNameFilter

string

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

OAuthInfo

ข้อมูลที่ใช้สำหรับการให้สิทธิ์โดยใช้ OAuth

การแสดง JSON 
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
ช่อง
httpMethod

string

เมธอด HTTP ที่ใช้เพื่อรับการให้สิทธิ์
httpRequestUrl

string

URL ของคำขอ HTTP ที่ใช้เพื่อรับการให้สิทธิ์
httpAuthorizationHeader

string

ส่วนหัวการให้สิทธิ์ HTTP ที่ใช้เพื่อรับการให้สิทธิ์

AffiliateLocationFeedData

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

การแสดง JSON 
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
ช่อง
chainIds[]

string (int64 format)

รายชื่อร้านในเครือที่ฟีดสถานที่ตั้งของแอฟฟิลิเอตจะซิงค์สถานที่ตั้ง
relationshipType

enum (AffiliateLocationFeedRelationshipType)

ความสัมพันธ์ที่เชนธุรกิจมีกับผู้ลงโฆษณา

AffiliateLocationFeedRelationshipType

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

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