ดัชนี
DataSourcesService
(อินเทอร์เฟซ)CreateDataSourceRequest
(ข้อความ)DataSource
(ข้อความ)DataSource.Input
(enum)DeleteDataSourceRequest
(ข้อความ)FetchDataSourceRequest
(ข้อความ)FileInput
(ข้อความ)FileInput.FetchSettings
(ข้อความ)FileInput.FetchSettings.Frequency
(enum)FileInput.FileInputType
(enum)GetDataSourceRequest
(ข้อความ)ListDataSourcesRequest
(ข้อความ)ListDataSourcesResponse
(ข้อความ)LocalInventoryDataSource
(ข้อความ)PrimaryProductDataSource
(ข้อความ)PrimaryProductDataSource.Channel
(enum)PromotionDataSource
(ข้อความ)RegionalInventoryDataSource
(ข้อความ)SupplementalProductDataSource
(ข้อความ)UpdateDataSourceRequest
(ข้อความ)
DataSourcesService
บริการสำหรับจัดการแหล่งข้อมูลหลัก ข้อมูลเสริม สินค้าคงคลัง และแหล่งข้อมูลอื่นๆ โปรดดูข้อมูลเพิ่มเติมได้ในบทความช่วยเหลือของ Merchant Center
CreateDataSource |
---|
สร้างการกำหนดค่าแหล่งข้อมูลใหม่สำหรับบัญชีที่กำหนด
|
DeleteDataSource |
---|
ลบแหล่งข้อมูลออกจากบัญชี Merchant Center
|
FetchDataSource |
---|
ดำเนินการดึงข้อมูลทันที (แม้นอกกำหนดการเรียกข้อมูล) ในแหล่งข้อมูลจากบัญชี Merchant Center หากต้องการเรียกใช้วิธีการนี้มากกว่า 1 ครั้งต่อวัน คุณควรใช้บริการผลิตภัณฑ์เพื่ออัปเดตข้อมูลผลิตภัณฑ์แทน วิธีนี้ใช้ได้เฉพาะกับแหล่งข้อมูลที่มีชุดอินพุตไฟล์
|
GetDataSource |
---|
เรียกข้อมูลการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ
|
ListDataSources |
---|
แสดงรายการการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ
|
UpdateDataSource |
---|
อัปเดตการกำหนดค่าแหล่งข้อมูลที่มีอยู่ ระบบจะลบช่องที่ตั้งค่าไว้ในมาสก์การอัปเดตแต่ไม่ได้ระบุไว้ในทรัพยากร
|
CreateDataSourceRequest
ข้อความคำขอสำหรับเมธอด CreateDataSource
ช่อง | |
---|---|
parent |
ต้องระบุ บัญชีที่จะสร้างแหล่งข้อมูลนี้ รูปแบบ: |
data_source |
ต้องระบุ แหล่งข้อมูลที่จะสร้าง |
DataSource
แหล่งข้อมูลสำหรับบัญชี Merchant Center
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของแหล่งข้อมูล รูปแบบ: |
data_source_id |
เอาต์พุตเท่านั้น รหัสแหล่งข้อมูล |
display_name |
ต้องระบุ ชื่อแหล่งข้อมูลที่แสดงใน UI ของ Merchant Center |
input |
เอาต์พุตเท่านั้น กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล การตั้งค่าบางอย่างอาจใช้งานไม่ได้ ทั้งนี้ขึ้นอยู่กับอินพุต คุณสร้างได้โดยใช้ API เฉพาะแหล่งข้อมูลทั่วไปเท่านั้น |
file_input |
ไม่บังคับ ระบบจะใช้ช่องนี้เมื่อมีการจัดการข้อมูลผ่านไฟล์เท่านั้น |
ช่องการรวม Type ประเภทแหล่งข้อมูล Type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
primary_product_data_source |
ต้องระบุ แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์ |
supplemental_product_data_source |
ต้องระบุ แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์ |
local_inventory_data_source |
ต้องระบุ แหล่งข้อมูลสินค้าคงคลังในร้าน |
regional_inventory_data_source |
ต้องระบุ แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค |
promotion_data_source |
ต้องระบุ แหล่งข้อมูลโปรโมชัน |
อินพุต
กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล ระบบอาจไม่รองรับการตั้งค่าบางอย่าง ทั้งนี้ขึ้นอยู่กับอินพุต
Enum | |
---|---|
INPUT_UNSPECIFIED |
ไม่ได้ระบุอินพุต |
API |
แสดงแหล่งข้อมูลที่ระบุข้อมูลผ่าน API เป็นหลัก |
FILE |
หมายถึงแหล่งข้อมูลที่มีการให้ข้อมูลผ่านอินพุตไฟล์เป็นหลัก ข้อมูลยังคงให้ผ่าน API ได้ |
UI |
แหล่งข้อมูลสำหรับผลิตภัณฑ์ที่เพิ่มลงใน Merchant Center โดยตรง และไม่สามารถสร้างหรืออัปเดตแหล่งข้อมูลประเภทนี้ผ่าน API นี้ แต่จะใช้ UI ของ Merchant Center ได้เท่านั้น แหล่งข้อมูลประเภทนี้เป็นแบบอ่านอย่างเดียว |
AUTOFEED |
วิธีนี้เรียกอีกอย่างว่าฟีดอัตโนมัติซึ่งใช้สร้างข้อมูลผลิตภัณฑ์โดยอัตโนมัติ คุณเปิดหรือปิดใช้แหล่งข้อมูลประเภทนี้ได้ผ่านกลุ่มบัญชี |
DeleteDataSourceRequest
ข้อความคำขอสำหรับเมธอด DeleteDataSource
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อของแหล่งข้อมูลที่จะลบ รูปแบบ: |
FetchDataSourceRequest
ข้อความคำขอสำหรับเมธอด FetchDataSource
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อของทรัพยากรแหล่งข้อมูลที่จะดึงข้อมูล รูปแบบ: |
FileInput
ข้อมูลเฉพาะสำหรับแหล่งข้อมูลไฟล์ ช่องนี้จะว่างเปล่าสําหรับอินพุตแหล่งข้อมูลอื่นๆ
ช่อง | |
---|---|
fetch_settings |
ไม่บังคับ เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล ซึ่งมีการตั้งค่าสำหรับอินพุตไฟล์ |
file_name |
ไม่บังคับ ชื่อไฟล์ของแหล่งข้อมูล จำเป็นสำหรับอินพุตไฟล์ |
file_input_type |
เอาต์พุตเท่านั้น ประเภทของอินพุตไฟล์ |
FetchSettings
ดึงข้อมูลรายละเอียดเพื่อส่งแหล่งข้อมูล
ช่อง | |
---|---|
enabled |
ไม่บังคับ เปิดใช้หรือหยุดกำหนดการเรียกข้อมูลชั่วคราว |
day_of_month |
ไม่บังคับ วันของเดือนที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล (1-31) ช่องนี้ตั้งค่าได้เฉพาะความถี่รายเดือนเท่านั้น |
time_of_day |
ไม่บังคับ ชั่วโมงของวันที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ระบบไม่รองรับนาทีและวินาทีและจะไม่สนใจ |
day_of_week |
ไม่บังคับ วันของสัปดาห์ที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ตั้งค่าช่องนี้สำหรับความถี่รายสัปดาห์เท่านั้น |
time_zone |
ไม่บังคับ เขตเวลาที่ใช้สำหรับกำหนดการ UTC โดยค่าเริ่มต้น เช่น "America/Los_Angeles" |
frequency |
ต้องระบุ ความถี่ที่อธิบายกำหนดการเรียกข้อมูล |
fetch_uri |
ไม่บังคับ 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 |
ความถี่
ช่องที่ต้องกรอกจะแตกต่างกันไปตามความถี่ในการดึงข้อมูล สำหรับกำหนดการเรียกข้อมูลรายเดือน ต้องระบุ [วันของเดือน][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 |
ระบบจะดึงไฟล์จาก [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] ที่กำหนดค่า |
GOOGLE_SHEETS |
ระบบจะดึงไฟล์จาก Google ชีตที่ระบุไว้ใน [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] |
GetDataSourceRequest
ข้อความคำขอสำหรับเมธอด GetDataSource
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อของแหล่งข้อมูลที่จะดึงข้อมูล รูปแบบ: |
ListDataSourcesRequest
ข้อความคําขอสำหรับเมธอด ListDataSources
ช่อง | |
---|---|
parent |
ต้องระบุ บัญชีที่จะแสดงแหล่งข้อมูล รูปแบบ: |
page_size |
ไม่บังคับ จำนวนแหล่งข้อมูลสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าสูงสุดคือ 1,000 ค่าที่มากกว่า 1000 จะถูกเปลี่ยนเป็น 1000 หากไม่ระบุ ระบบจะแสดงผลจำนวนแหล่งข้อมูลสูงสุด |
page_token |
ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการโทร เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ |
ListDataSourcesResponse
ข้อความตอบกลับสำหรับเมธอด ListDataSources
ช่อง | |
---|---|
data_sources[] |
แหล่งข้อมูลจากบัญชีที่ระบุ |
next_page_token |
โทเค็นซึ่งสามารถส่งเป็น |
LocalInventoryDataSource
แหล่งข้อมูลสินค้าคงคลังในร้าน
ช่อง | |
---|---|
feed_label |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่แสดงสินค้าคงคลังในร้าน ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด |
content_language |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังในร้าน |
PrimaryProductDataSource
แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
ช่อง | |
---|---|
channel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุประเภทของแชแนลของแหล่งข้อมูล |
countries[] |
ไม่บังคับ ประเทศที่อาจแสดงสินค้า แสดงเป็นรหัสเขตแดน CLDR |
feed_label |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุในระดับแหล่งข้อมูล ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด ต้องตั้งค่าหรือไม่ได้ตั้งค่า หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
content_language |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล ต้องตั้งค่าทั้ง หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว |
ช่อง
แชแนลแหล่งข้อมูล
แชแนลใช้เพื่อแยกแหล่งข้อมูลสำหรับประเภทธุรกิจที่แตกต่างกัน
Enum | |
---|---|
CHANNEL_UNSPECIFIED |
ไม่ได้ระบุ |
ONLINE_PRODUCTS |
ผลิตภัณฑ์ออนไลน์ |
LOCAL_PRODUCTS |
ผลิตภัณฑ์ในร้าน |
PRODUCTS |
แหล่งข้อมูลแบบรวมสำหรับผลิตภัณฑ์ทั้งในท้องถิ่นและออนไลน์ หมายเหตุ: ช่องทางนี้ไม่สามารถจัดการผลิตภัณฑ์ผ่าน API ได้ |
PromotionDataSource
แหล่งข้อมูลโปรโมชัน
ช่อง | |
---|---|
target_country |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR โปรโมชันมีให้บริการเฉพาะในประเทศที่เลือกเท่านั้น |
content_language |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล |
RegionalInventoryDataSource
แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค
ช่อง | |
---|---|
feed_label |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่ระบุสินค้าคงคลังระดับภูมิภาค ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด |
content_language |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังระดับภูมิภาค |
SupplementalProductDataSource
แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
ช่อง | |
---|---|
feed_label |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุในระดับแหล่งข้อมูล ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-) ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด ต้องตั้งค่าหรือไม่ได้ตั้งค่า หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว |
content_language |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล ต้องตั้งค่าทั้ง หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว |
UpdateDataSourceRequest
ข้อความคำขอสำหรับเมธอด UpdateDataSource
ช่อง | |
---|---|
data_source |
ต้องระบุ ทรัพยากรแหล่งข้อมูลที่จะอัปเดต |
update_mask |
ต้องระบุ รายการฟิลด์แหล่งข้อมูลที่จะอัปเดต ระบบจะลบช่องที่ระบุในมาสก์การอัปเดตโดยไม่ระบุค่าในเนื้อหาออกจากแหล่งข้อมูล การระบุ "*" พิเศษ ไม่รองรับค่าสำหรับการแทนที่แหล่งข้อมูลทั้งหมด |