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)

เปลี่ยนแปลงไม่ได้ ระบุผู้ที่จัดการแอตทริบิวต์ฟีดสำหรับฟีด

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 ซึ่งจะมีค่าเริ่มต้นเป็น false หากไม่ระบุไว้ โปรดทราบว่าสคีมาของฟีดไม่จำเป็นต้องมีคีย์ที่ไม่ซ้ำกัน ซึ่งในกรณีนี้ฟีด_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 แอตทริบิวต์ฟีดสำหรับฟีดนี้ได้รับการจัดการโดยผู้ใช้ ผู้ใช้สามารถเพิ่มแอตทริบิวต์ฟีดลงในฟีดนี้ได้
GOOGLE แอตทริบิวต์ฟีดสำหรับฟีดของ 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 หากไม่มีรายการอยู่ในตัวกรองหมวดหมู่ รายชื่อทั้งหมดก็เป็นตัวเลือกสำหรับการซิงค์

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 ความสัมพันธ์กับผู้ค้าปลีกทั่วไป