- ทรัพยากร: DataSource
- PrimaryProductDataSource
- ช่อง
- DefaultRule
- DataSourceReference
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- ProductReviewDataSource
- MerchantReviewDataSource
- อินพุต
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- ความถี่
- FileInputType
- เมธอด
ทรัพยากร: DataSource
แหล่งข้อมูลสำหรับบัญชี Merchant Center
การแสดง JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อแหล่งข้อมูล รูปแบบ: |
data |
เอาต์พุตเท่านั้น รหัสแหล่งข้อมูล |
display |
ต้องระบุ ชื่อแหล่งข้อมูลที่แสดงใน UI ของ Merchant Center |
input |
เอาต์พุตเท่านั้น กำหนดประเภทอินพุตไปยังแหล่งข้อมูล การตั้งค่าบางอย่างอาจไม่ทำงานตามข้อมูลที่คุณป้อน มีเพียงแหล่งข้อมูลทั่วไปเท่านั้นที่สร้างผ่าน API ได้ |
file |
ไม่บังคับ ระบบจะใช้ช่องนี้เฉพาะเมื่อจัดการข้อมูลผ่านไฟล์เท่านั้น |
ฟิลด์สหภาพ Type ประเภทแหล่งข้อมูล Type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
primary |
ต้องระบุ แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในร้านและออนไลน์ |
supplemental |
ต้องระบุ แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในร้านและออนไลน์ |
local |
ต้องระบุ แหล่งข้อมูลสินค้าคงคลังในร้าน |
regional |
ต้องระบุ แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค |
promotion |
ต้องระบุ แหล่งข้อมูลโปรโมชัน |
product |
ต้องระบุ แหล่งข้อมูลรีวิวผลิตภัณฑ์ |
merchant |
ต้องระบุ แหล่งข้อมูลรีวิวผู้ขาย |
PrimaryProductDataSource
แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในร้านและออนไลน์
การแสดง JSON |
---|
{ "channel": enum ( |
ช่อง | |
---|---|
channel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุประเภทของช่องทางแหล่งข้อมูล |
countries[] |
ไม่บังคับ ประเทศที่อาจแสดงสินค้า แสดงเป็นรหัสเขตแดน CLDR |
default |
ไม่บังคับ การจัดการกฎเริ่มต้นของแหล่งข้อมูล หากตั้งค่าไว้ ระบบจะแทนที่แหล่งข้อมูลที่ลิงก์ |
feed |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุไว้ที่ระดับแหล่งข้อมูล ต้องมีอักขระไม่เกิน 20 ตัว โดยเป็นตัวอักษรตัวพิมพ์ใหญ่ (A-Z), ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมได้ที่การย้ายข้อมูลไปยังป้ายกํากับฟีด
หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้เท่านั้น หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
content |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล
หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้เท่านั้น หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
ช่อง
ช่องแหล่งข้อมูล
ช่องทางใช้เพื่อแยกความแตกต่างระหว่างแหล่งข้อมูลของประเภทผลิตภัณฑ์ต่างๆ
Enum | |
---|---|
CHANNEL_UNSPECIFIED |
ไม่ได้ระบุ |
ONLINE_PRODUCTS |
ผลิตภัณฑ์ออนไลน์ |
LOCAL_PRODUCTS |
ผลิตภัณฑ์ในร้าน |
PRODUCTS |
แหล่งข้อมูลที่รวมสำหรับทั้งผลิตภัณฑ์ในร้านและออนไลน์ หมายเหตุ: การจัดการผลิตภัณฑ์ผ่าน API จะใช้ไม่ได้กับช่องทางนี้ |
DefaultRule
การจัดการกฎเริ่มต้นของแหล่งข้อมูล
การแสดง JSON |
---|
{
"takeFromDataSources": [
{
object ( |
ช่อง | |
---|---|
take |
ต้องระบุ รายการแหล่งข้อมูลที่ลิงก์ในกฎเริ่มต้น รายการนี้จะเรียงตามลําดับความสําคัญของกฎเริ่มต้นในการรวมข้อมูล โดยอาจไม่มีหรือมีการอ้างอิงถึง รายการต้องไม่ว่างเปล่า หากต้องการลิงก์แหล่งข้อมูลกับกฎเริ่มต้น คุณต้องเพิ่มการอ้างอิงใหม่ลงในรายการนี้ (ตามลําดับ) หากต้องการยกเลิกการลิงก์แหล่งข้อมูลกับกฎเริ่มต้น คุณต้องนําการอ้างอิงนั้นออกจากรายการนี้ การเปลี่ยนลําดับของรายการนี้จะทําให้ลําดับความสําคัญของแหล่งข้อมูลในกฎเริ่มต้นเปลี่ยนแปลงไปด้วย เช่น การให้รายการต่อไปนี้ [ |
DataSourceReference
คุณสามารถใช้ข้อมูลอ้างอิงแหล่งข้อมูลเพื่อจัดการแหล่งข้อมูลที่เกี่ยวข้องภายในบริการแหล่งข้อมูลได้
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ
|
|
self |
คุณควรใช้ Self เพื่ออ้างอิงแหล่งข้อมูลหลัก |
primary |
ไม่บังคับ ชื่อแหล่งข้อมูลหลัก รูปแบบ: |
supplemental |
ไม่บังคับ ชื่อแหล่งข้อมูลเสริม รูปแบบ: |
SupplementalProductDataSource
แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในร้านและออนไลน์ หลังจากสร้างแล้ว คุณควรลิงก์แหล่งข้อมูลผลิตภัณฑ์เสริมกับแหล่งข้อมูลผลิตภัณฑ์หลักอย่างน้อย 1 แหล่ง
การแสดง JSON |
---|
{
"referencingPrimaryDataSources": [
{
object ( |
ช่อง | |
---|---|
referencing |
เอาต์พุตเท่านั้น รายการแหล่งข้อมูลหลักทั้งหมด (ไม่เป็นระเบียบและกรองข้อมูลที่ซ้ำกันออกแล้ว) ที่ลิงก์กับแหล่งข้อมูลนี้ในกฎเริ่มต้นหรือกฎที่กําหนดเอง คุณจะลบแหล่งข้อมูลเสริมไม่ได้จนกว่าจะนําลิงก์ทั้งหมดออก |
feed |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุไว้ที่ระดับแหล่งข้อมูล ต้องมีอักขระไม่เกิน 20 ตัว โดยเป็นตัวอักษรตัวพิมพ์ใหญ่ (A-Z), ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมได้ที่การย้ายข้อมูลไปยังป้ายกํากับฟีด
โดยต้องตั้งค่าสำหรับแหล่งข้อมูลที่มี หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้เท่านั้น หากไม่ได้ตั้งค่าไว้ แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
content |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล
หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้เท่านั้น หากไม่ได้ตั้งค่าไว้ แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
LocalInventoryDataSource
แหล่งข้อมูลสินค้าคงคลังในร้าน
การแสดง JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
ช่อง | |
---|---|
feed |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดของข้อเสนอที่มีการแสดงสินค้าคงคลังในร้าน ต้องมีอักขระไม่เกิน 20 ตัว โดยเป็นตัวอักษรตัวพิมพ์ใหญ่ (A-Z), ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมได้ที่การย้ายข้อมูลไปยังป้ายกํากับฟีด |
content |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่มีการแสดงสินค้าคงคลังในร้าน |
RegionalInventoryDataSource
แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค
การแสดง JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
ช่อง | |
---|---|
feed |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่มีสินค้าคงคลังระดับภูมิภาค ต้องมีอักขระไม่เกิน 20 ตัว โดยเป็นตัวอักษรตัวพิมพ์ใหญ่ (A-Z), ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมได้ที่การย้ายข้อมูลไปยังป้ายกํากับฟีด |
content |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการที่มีการแสดงสินค้าคงคลังระดับภูมิภาค |
PromotionDataSource
แหล่งข้อมูลโปรโมชัน
การแสดง JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
ช่อง | |
---|---|
target |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำ แสดงเป็นรหัสเขตแดน CLDR โปรโมชันใช้ได้ในบางประเทศเท่านั้น |
content |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล |
ProductReviewDataSource
ประเภทนี้ไม่มีช่อง
แหล่งข้อมูลรีวิวผลิตภัณฑ์
MerchantReviewDataSource
ประเภทนี้ไม่มีช่อง
แหล่งข้อมูลรีวิวผู้ขาย
อินพุต
กำหนดประเภทอินพุตไปยังแหล่งข้อมูล ระบบอาจไม่รองรับการตั้งค่าบางอย่างตามข้อมูลที่คุณป้อน
Enum | |
---|---|
INPUT_UNSPECIFIED |
ไม่ได้ระบุอินพุต |
API |
แสดงแหล่งข้อมูลที่ให้ข้อมูลผ่าน API เป็นหลัก |
FILE |
แสดงแหล่งข้อมูลที่มีการจัดเตรียมข้อมูลผ่านอินพุตไฟล์เป็นหลัก แต่คุณยังคงส่งข้อมูลผ่าน API ได้ |
UI |
แหล่งข้อมูลของผลิตภัณฑ์ที่เพิ่มใน Merchant Center โดยตรง แหล่งข้อมูลประเภทนี้สร้างหรืออัปเดตผ่าน API นี้ไม่ได้ ทำได้ผ่าน UI ของ Merchant Center เท่านั้น แหล่งข้อมูลประเภทนี้เป็นแบบอ่านอย่างเดียว |
AUTOFEED |
หรือที่เรียกว่าฟีดอัตโนมัติ ซึ่งใช้สร้างข้อมูลผลิตภัณฑ์โดยอัตโนมัติ แหล่งข้อมูลประเภทนี้สามารถเปิดหรือปิดใช้ได้ผ่านแพ็กเกจบัญชี |
FileInput
ข้อมูลที่เจาะจงสําหรับแหล่งข้อมูลไฟล์ ช่องนี้จะว่างเปล่าสำหรับอินพุตแหล่งข้อมูลอื่นๆ
การแสดง JSON |
---|
{ "fetchSettings": { object ( |
ช่อง | |
---|---|
fetch |
ไม่บังคับ ดึงข้อมูลรายละเอียดเพื่อส่งแหล่งข้อมูล ซึ่งมีการตั้งค่าสำหรับประเภทอินพุตไฟล์ |
file |
ไม่บังคับ ชื่อไฟล์ของแหล่งข้อมูล ต้องระบุสำหรับประเภทอินพุตไฟล์ |
file |
เอาต์พุตเท่านั้น ประเภทของอินพุตไฟล์ |
FetchSettings
ดึงข้อมูลรายละเอียดเพื่อส่งแหล่งข้อมูล
การแสดง JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
ช่อง | |
---|---|
enabled |
ไม่บังคับ เปิดหรือหยุดกำหนดเวลาการดึงข้อมูลชั่วคราว |
day |
ไม่บังคับ วันที่ของเดือนที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล (1-31) ฟิลด์นี้ตั้งค่าได้เฉพาะความถี่รายเดือนเท่านั้น |
time |
ไม่บังคับ ชั่วโมงของวันที่ที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ระบบจะไม่รองรับและละเว้นนาทีและวินาที |
day |
ไม่บังคับ วันในสัปดาห์ที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ฟิลด์นี้ตั้งค่าได้เฉพาะความถี่รายสัปดาห์เท่านั้น |
time |
ไม่บังคับ เขตเวลาที่ใช้สำหรับกำหนดการ UTC โดยค่าเริ่มต้น เช่น "America/Los_Angeles" |
frequency |
ต้องระบุ ความถี่ที่อธิบายกำหนดเวลาการดึงข้อมูล |
fetch |
ไม่บังคับ URL ที่ดึงข้อมูลไฟล์แหล่งข้อมูลได้ Google Merchant Center รองรับการอัปโหลดตามกำหนดการอัตโนมัติโดยใช้โปรโตคอล HTTP, HTTPS หรือ SFTP ดังนั้นค่าจะต้องเป็นลิงก์ที่ถูกต้องซึ่งใช้โปรโตคอลอย่างใดอย่างหนึ่งใน 3 โปรโตคอลดังกล่าว ไม่สามารถแก้ไขได้สำหรับไฟล์ Google ชีต |
username |
ไม่บังคับ ชื่อผู้ใช้สำหรับ |
password |
ไม่บังคับ รหัสผ่านสำหรับ |
TimeOfDay
แสดงช่วงเวลาของวัน วันที่และเขตเวลาไม่สำคัญหรือระบุไว้ที่อื่น API อาจเลือกที่จะอนุญาตวินาทีของ leap ประเภทที่เกี่ยวข้องคือ google.type.Date
และ google.protobuf.Timestamp
การแสดง JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
ช่อง | |
---|---|
hours |
ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และโดยทั่วไปต้องน้อยกว่าหรือเท่ากับ 23 API อาจเลือกที่จะอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ |
minutes |
นาทีของชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 59 |
seconds |
วินาทีใน 1 นาที ต้องมากกว่าหรือเท่ากับ 0 และโดยทั่วไปต้องน้อยกว่าหรือเท่ากับ 59 API อาจอนุญาตให้ใช้ค่า 60 ได้หากอนุญาตให้ใช้วินาทีของ leap |
nanos |
เศษส่วนของวินาทีเป็นนาโนวินาที ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 999,999,999 |
วันของสัปดาห์
แสดงวันของสัปดาห์
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
ไม่ระบุวันของสัปดาห์ |
MONDAY |
วันจันทร์ |
TUESDAY |
อังคาร |
WEDNESDAY |
พุธ |
THURSDAY |
พฤหัสบดี |
FRIDAY |
ศุกร์ |
SATURDAY |
เสาร์ |
SUNDAY |
วันอาทิตย์ |
ความถี่
ช่องที่ต้องกรอกจะแตกต่างกันไปตามความถี่ในการดึงข้อมูล สำหรับกำหนดการดึงข้อมูลรายเดือน คุณต้องใช้ [day of month][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] และ [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] สำหรับกำหนดเวลาการเรียกข้อมูลรายสัปดาห์ คุณจำเป็นต้องระบุ [day of week][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] และ [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] สำหรับกำหนดเวลาการเรียกข้อมูลรายวัน คุณต้องใช้เฉพาะ [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] เท่านั้น
Enum | |
---|---|
FREQUENCY_UNSPECIFIED |
ไม่ระบุความถี่ |
FREQUENCY_DAILY |
การดึงข้อมูลจะเกิดขึ้นทุกวัน |
FREQUENCY_WEEKLY |
การดึงข้อมูลจะเกิดขึ้นทุกสัปดาห์ |
FREQUENCY_MONTHLY |
การดึงข้อมูลจะเกิดขึ้นทุกเดือน |
FileInputType
วิธีนำส่งไฟล์
Enum | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทการป้อนข้อมูลไฟล์ |
UPLOAD |
อัปโหลดไฟล์ผ่าน SFTP, Google Cloud Storage หรืออัปโหลดด้วยตนเองใน Merchant Center |
FETCH |
ระบบจะดึงข้อมูลไฟล์จาก fetchUri ที่กําหนดค่าไว้ |
GOOGLE_SHEETS |
ระบบจะดึงข้อมูลไฟล์จาก Google ชีตที่ระบุใน fetchUri |
เมธอด |
|
---|---|
|
สร้างการกําหนดค่าแหล่งข้อมูลใหม่สําหรับบัญชีที่ระบุ |
|
ลบแหล่งข้อมูลจากบัญชี Merchant Center |
|
ดึงข้อมูลทันที (แม้ไม่ได้อยู่ในกำหนดการดึงข้อมูล) ในแหล่งข้อมูลจากบัญชี Merchant Center |
|
ดึงข้อมูลการกําหนดค่าแหล่งข้อมูลสําหรับบัญชีที่ระบุ |
|
แสดงรายการการกําหนดค่าสําหรับแหล่งข้อมูลของบัญชีที่ระบุ |
|
อัปเดตการกําหนดค่าแหล่งข้อมูลที่มีอยู่ |