- แหล่งข้อมูล: แหล่งข้อมูล
- PrimaryProductDataSource
- ช่อง
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- อินพุต
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- ความถี่
- FileInputType
- เมธอด
ทรัพยากร: แหล่งข้อมูล
แหล่งข้อมูลสำหรับบัญชี Merchant Center
การแสดง JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของแหล่งข้อมูล รูปแบบ: |
dataSourceId |
เอาต์พุตเท่านั้น รหัสแหล่งข้อมูล |
displayName |
ต้องระบุ ชื่อแหล่งข้อมูลที่แสดงใน UI ของ Merchant Center |
input |
เอาต์พุตเท่านั้น กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล การตั้งค่าบางอย่างอาจใช้งานไม่ได้ ทั้งนี้ขึ้นอยู่กับอินพุต คุณสร้างได้โดยใช้ API เฉพาะแหล่งข้อมูลทั่วไปเท่านั้น |
fileInput |
ไม่บังคับ ระบบจะใช้ช่องนี้เมื่อมีการจัดการข้อมูลผ่านไฟล์เท่านั้น |
ช่องการรวม Type ประเภทแหล่งข้อมูล Type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
primaryProductDataSource |
ต้องระบุ แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์ |
supplementalProductDataSource |
ต้องระบุ แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์ |
localInventoryDataSource |
ต้องระบุ แหล่งข้อมูลสินค้าคงคลังในร้าน |
regionalInventoryDataSource |
ต้องระบุ แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค |
promotionDataSource |
ต้องระบุ แหล่งข้อมูลโปรโมชัน |
PrimaryProductDataSource
แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
การแสดง JSON |
---|
{
"channel": enum ( |
ช่อง | |
---|---|
channel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุประเภทของแชแนลของแหล่งข้อมูล |
countries[] |
ไม่บังคับ ประเทศที่อาจแสดงสินค้า แสดงเป็นรหัสเขตแดน CLDR |
feedLabel |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุไว้ในระดับแหล่งข้อมูล ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด ต้องตั้งค่าหรือไม่ได้ตั้งค่า หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
contentLanguage |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล ต้องตั้งค่าทั้ง หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
ช่อง
แชแนลแหล่งข้อมูล
แชแนลใช้เพื่อแยกแหล่งข้อมูลสำหรับประเภทธุรกิจที่แตกต่างกัน
Enum | |
---|---|
CHANNEL_UNSPECIFIED |
ไม่ได้ระบุ |
ONLINE_PRODUCTS |
ผลิตภัณฑ์ออนไลน์ |
LOCAL_PRODUCTS |
ผลิตภัณฑ์ในร้าน |
PRODUCTS |
แหล่งข้อมูลแบบรวมสำหรับผลิตภัณฑ์ทั้งในท้องถิ่นและออนไลน์ หมายเหตุ: ช่องทางนี้ไม่สามารถจัดการผลิตภัณฑ์ผ่าน API ได้ |
SupplementalProductDataSource
แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
การแสดง JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
ช่อง | |
---|---|
feedLabel |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุไว้ในระดับแหล่งข้อมูล ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด ต้องตั้งค่าหรือไม่ได้ตั้งค่า หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว |
contentLanguage |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล ต้องตั้งค่าทั้ง หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว |
LocalInventoryDataSource
แหล่งข้อมูลสินค้าคงคลังในร้าน
การแสดง JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
ช่อง | |
---|---|
feedLabel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่แสดงสินค้าคงคลังในร้าน ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด |
contentLanguage |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังในร้าน |
RegionalInventoryDataSource
แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค
การแสดง JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
ช่อง | |
---|---|
feedLabel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่ระบุสินค้าคงคลังระดับภูมิภาค ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด |
contentLanguage |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังระดับภูมิภาค |
PromotionDataSource
แหล่งข้อมูลโปรโมชัน
การแสดง JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
ช่อง | |
---|---|
targetCountry |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR โปรโมชันมีให้บริการเฉพาะในประเทศที่เลือกเท่านั้น |
contentLanguage |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล |
อินพุต
กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล ระบบอาจไม่รองรับการตั้งค่าบางอย่าง ทั้งนี้ขึ้นอยู่กับอินพุต
Enum | |
---|---|
INPUT_UNSPECIFIED |
ไม่ได้ระบุอินพุต |
API |
แสดงแหล่งข้อมูลที่ระบุข้อมูลผ่าน API เป็นหลัก |
FILE |
หมายถึงแหล่งข้อมูลที่มีการให้ข้อมูลผ่านอินพุตไฟล์เป็นหลัก ข้อมูลยังคงให้ผ่าน API ได้ |
UI |
แหล่งข้อมูลสำหรับผลิตภัณฑ์ที่เพิ่มลงใน Merchant Center โดยตรง และไม่สามารถสร้างหรืออัปเดตแหล่งข้อมูลประเภทนี้ผ่าน API นี้ แต่จะใช้ UI ของ Merchant Center ได้เท่านั้น แหล่งข้อมูลประเภทนี้เป็นแบบอ่านอย่างเดียว |
AUTOFEED |
วิธีนี้เรียกอีกอย่างว่าฟีดอัตโนมัติซึ่งใช้สร้างข้อมูลผลิตภัณฑ์โดยอัตโนมัติ คุณเปิดหรือปิดใช้แหล่งข้อมูลประเภทนี้ได้ผ่านกลุ่มบัญชี |
FileInput
ข้อมูลเฉพาะสำหรับแหล่งข้อมูลไฟล์ ช่องนี้จะว่างเปล่าสําหรับอินพุตแหล่งข้อมูลอื่นๆ
การแสดง JSON |
---|
{ "fetchSettings": { object ( |
ช่อง | |
---|---|
fetchSettings |
ไม่บังคับ เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล ซึ่งมีการตั้งค่าสำหรับอินพุตไฟล์ |
fileName |
ไม่บังคับ ชื่อไฟล์ของแหล่งข้อมูล จำเป็นสำหรับอินพุตไฟล์ |
fileInputType |
เอาต์พุตเท่านั้น ประเภทของอินพุตไฟล์ |
FetchSettings
เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล
การแสดง JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
ช่อง | |
---|---|
enabled |
ไม่บังคับ เปิดใช้หรือหยุดกำหนดการเรียกข้อมูลชั่วคราว |
dayOfMonth |
ไม่บังคับ วันของเดือนที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล (1-31) ช่องนี้ตั้งค่าได้เฉพาะความถี่รายเดือนเท่านั้น |
timeOfDay |
ไม่บังคับ ชั่วโมงของวันที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ระบบไม่รองรับนาทีและวินาทีและจะไม่สนใจ |
dayOfWeek |
ไม่บังคับ วันของสัปดาห์ที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ตั้งค่าช่องนี้สำหรับความถี่รายสัปดาห์เท่านั้น |
timeZone |
ไม่บังคับ เขตเวลาที่ใช้สำหรับกำหนดการ UTC โดยค่าเริ่มต้น เช่น "America/Los_Angeles" |
frequency |
ต้องระบุ ความถี่ที่อธิบายกำหนดการเรียกข้อมูล |
fetchUri |
ไม่บังคับ URL ที่สามารถดึงข้อมูลไฟล์แหล่งข้อมูลได้ Google Merchant Center รองรับการอัปโหลดที่ตั้งเวลาไว้อัตโนมัติโดยใช้โปรโตคอล HTTP, HTTPS หรือ SFTP ดังนั้นค่าจะต้องเป็นลิงก์ที่ถูกต้องโดยใช้โปรโตคอล 1 ใน 3 รายการข้างต้น เปลี่ยนแปลงไม่ได้สำหรับไฟล์ Google ชีต |
username |
ไม่บังคับ ชื่อผู้ใช้ที่ไม่บังคับสำหรับ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] ใช้สำหรับการส่งแหล่งข้อมูลผ่าน SFTP |
password |
ไม่บังคับ รหัสผ่านที่ไม่บังคับสำหรับ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] ใช้สำหรับการส่งแหล่งข้อมูลผ่าน SFTP |
TimeOfDay
แสดงช่วงเวลาของวัน วันที่และเขตเวลาไม่มีความสำคัญหรือมีการระบุไว้ที่อื่น API อาจเลือกอนุญาตการใช้เวลาไม่กี่วินาที ประเภทที่เกี่ยวข้องคือ 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 |
เวลาเป็นวินาที โดยปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตให้ใช้ค่า 60 หากอนุญาตให้มีวินาทีอธิกวาร |
nanos |
เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมีค่าตั้งแต่ 0 ถึง 999,999,999 |
วันของสัปดาห์
แสดงวันของสัปดาห์
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
ไม่ระบุวันของสัปดาห์ |
MONDAY |
วันจันทร์ |
TUESDAY |
อังคาร |
WEDNESDAY |
พุธ |
THURSDAY |
พฤหัสบดี |
FRIDAY |
ศุกร์ |
SATURDAY |
เสาร์ |
SUNDAY |
วันอาทิตย์ |
ความถี่
ช่องที่ต้องกรอกจะแตกต่างกันไปตามความถี่ในการดึงข้อมูล สำหรับกำหนดการเรียกข้อมูลรายเดือน ต้องระบุ [วันของเดือน][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] และ [ชั่วโมงของวัน][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] สำหรับกำหนดการเรียกข้อมูลรายสัปดาห์ ต้องระบุ [วันในสัปดาห์][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] และ [hours of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_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.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] ที่กำหนดค่า |
GOOGLE_SHEETS |
ระบบจะดึงไฟล์จาก Google ชีตที่ระบุไว้ใน [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] |
เมธอด |
|
---|---|
|
สร้างการกำหนดค่าแหล่งข้อมูลใหม่สำหรับบัญชีที่กำหนด |
|
ลบแหล่งข้อมูลออกจากบัญชี Merchant Center |
|
ดำเนินการดึงข้อมูลทันที (แม้นอกกำหนดการเรียกข้อมูล) ในแหล่งข้อมูลจากบัญชี Merchant Center |
|
เรียกข้อมูลการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ |
|
แสดงรายการการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ |
|
อัปเดตการกำหนดค่าแหล่งข้อมูลที่มีอยู่ |