REST Resource: accounts.products

แหล่งข้อมูล: ผลิตภัณฑ์

ผลิตภัณฑ์ที่ประมวลผลแล้ว ซึ่งสร้างจากproduct inputsหลายรายการหลังจากใช้กฎและแหล่งข้อมูลเสริม ผลิตภัณฑ์ที่ประมวลผลนี้จะตรงกับสิ่งที่แสดงในบัญชี Merchant Center, โฆษณา Shopping และแพลตฟอร์มอื่นๆ ของ Google ผลิตภัณฑ์แต่ละรายการสร้างขึ้นจากอินพุตผลิตภัณฑ์แหล่งข้อมูลหลักเพียงรายการเดียว และอินพุตแหล่งข้อมูลเสริมหลายรายการ หลังจากแทรก อัปเดต หรือลบอินพุตผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีก่อนที่จะดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งอัปเดตแล้วได้

ช่องทั้งหมดในผลิตภัณฑ์ที่ประมวลผลและข้อความย่อยของผลิตภัณฑ์นั้นตรงกับชื่อแอตทริบิวต์ที่เกี่ยวข้องในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์ โดยมีข้อยกเว้นบางประการ

การแสดง JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
ช่อง
name

string

ชื่อผลิตภัณฑ์ รูปแบบ: "{product.name=accounts/{account}/products/{product}}" โดยส่วนที่แล้ว product ประกอบด้วย 4 ส่วน ได้แก่ channel~contentLanguage~feedLabel~offerId ตัวอย่างสำหรับชื่อผลิตภัณฑ์คือ "accounts/123/products/online~en~US~sku123"
channel

enum (ChannelEnum)

เอาต์พุตเท่านั้น ช่องทางของผลิตภัณฑ์
offerId

string

เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์ ซึ่งจะเหมือนกันสำหรับข้อมูลผลิตภัณฑ์และผลิตภัณฑ์ที่ประมวลผลแล้ว ระบบจะนำช่องว่างขึ้นต้นและต่อท้ายออก และจะแทนที่ช่องว่างหลายช่องด้วยช่องว่างเดี่ยวเมื่อส่ง ดูรายละเอียดได้ในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์
contentLanguage

string

เอาต์พุตเท่านั้น รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรของผลิตภัณฑ์
feedLabel

string

เอาต์พุตเท่านั้น ป้ายกำกับฟีดของผลิตภัณฑ์
dataSource

string

เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของผลิตภัณฑ์
attributes

object (Attributes)

เอาต์พุตเท่านั้น รายการแอตทริบิวต์ผลิตภัณฑ์
customAttributes[]

object (CustomAttribute)

เอาต์พุตเท่านั้น รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้เพื่อส่งแอตทริบิวต์ของข้อกำหนดเฉพาะของข้อมูลในรูปแบบทั่วไปได้ด้วย (เช่น { "name": "size type", "value": "regular" }) ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน เช่น แอตทริบิวต์เพิ่มเติมที่ใช้สำหรับ "ซื้อใน Google"
productStatus

object (ProductStatus)

เอาต์พุตเท่านั้น สถานะของผลิตภัณฑ์ ปัญหาการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับผลิตภัณฑ์ที่ประมวลผลแบบไม่พร้อมกัน
versionNumber

string (int64 format)

เอาต์พุตเท่านั้น แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของผลิตภัณฑ์ ซึ่งสามารถใช้เพื่อรักษาลำดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน

หากตั้งค่าไว้ ระบบจะป้องกันไม่ให้แทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของผลิตภัณฑ์ที่มีอยู่ คุณสามารถแทรก versionNumber ใหม่ได้ (เช่น รีเฟรชผลิตภัณฑ์หลังจากผ่านไป 30 วัน)

รองรับเฉพาะการแทรกลงในแหล่งข้อมูลหลัก

หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก

ProductStatus

สถานะของผลิตภัณฑ์ ปัญหาการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับผลิตภัณฑ์ที่ประมวลผลแบบไม่พร้อมกัน

การแสดง JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
ช่อง
destinationStatuses[]

object (DestinationStatus)

ปลายทางที่ต้องการสำหรับผลิตภัณฑ์
itemLevelIssues[]

object (ItemLevelIssue)

รายการปัญหาทั้งหมดที่เกี่ยวข้องกับผลิตภัณฑ์
creationDate

string (Timestamp format)

วันที่สร้างรายการในรูปแบบ ISO 8601
lastUpdateDate

string (Timestamp format)

วันที่อัปเดตรายการล่าสุดในรูปแบบ ISO 8601
googleExpirationDate

string (Timestamp format)

วันที่สินค้าหมดอายุในรูปแบบ ISO 8601

DestinationStatus

สถานะปลายทางของสถานะผลิตภัณฑ์

การแสดง JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
ช่อง
reportingContext

enum (ReportingContextEnum)

ชื่อของบริบทการรายงาน
approvedCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอได้รับอนุมัติ
pendingCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอรอการอนุมัติ
disapprovedCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่ข้อเสนอไม่ได้รับอนุมัติ

ItemLevelIssue

ItemLevelIssue ของสถานะผลิตภัณฑ์

การแสดง JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
ช่อง
code

string

รหัสข้อผิดพลาดของปัญหา
severity

enum (Severity)

ปัญหานี้ส่งผลต่อการแสดงข้อเสนออย่างไร
resolution

string

ผู้ขายสามารถแก้ไขปัญหาได้หรือไม่
attribute

string

ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์รายการเดียว
reportingContext

enum (ReportingContextEnum)

บริบทการรายงานที่มีปัญหา
description

string

คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ
detail

string

คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ
documentation

string

URL ของหน้าเว็บเพื่อช่วยแก้ปัญหานี้
applicableCountries[]

string

รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่มีปัญหากับข้อเสนอ

ความรุนแรง

ปัญหาส่งผลต่อการแสดงผลิตภัณฑ์อย่างไร

Enum
SEVERITY_UNSPECIFIED ไม่ได้ระบุ
NOT_IMPACTED ปัญหานี้แสดงถึงคำเตือนและจะไม่ส่งผลโดยตรงต่อผลิตภัณฑ์
DEMOTED ผลิตภัณฑ์ถูกลดระดับและมีแนวโน้มที่จะมีประสิทธิภาพที่จำกัดในผลการค้นหา
DISAPPROVED ปัญหาทำให้ผลิตภัณฑ์ไม่ได้รับอนุมัติ

เมธอด

get

 ดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วจากบัญชี Merchant Center

list

 แสดงผลิตภัณฑ์ที่ประมวลผลแล้วในบัญชี Merchant Center