Package google.shopping.merchant.datasources.v1beta

ดัชนี

DataSourcesService

บริการสำหรับจัดการแหล่งข้อมูลหลัก ข้อมูลเสริม สินค้าคงคลัง และแหล่งข้อมูลอื่นๆ โปรดดูข้อมูลเพิ่มเติมได้ในบทความช่วยเหลือของ Merchant Center

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

สร้างการกำหนดค่าแหล่งข้อมูลใหม่สำหรับบัญชีที่กำหนด

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

ลบแหล่งข้อมูลออกจากบัญชี Merchant Center

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

ดำเนินการดึงข้อมูลทันที (แม้นอกกำหนดการเรียกข้อมูล) ในแหล่งข้อมูลจากบัญชี Merchant Center หากต้องการเรียกใช้วิธีการนี้มากกว่า 1 ครั้งต่อวัน คุณควรใช้บริการผลิตภัณฑ์เพื่ออัปเดตข้อมูลผลิตภัณฑ์แทน วิธีนี้ใช้ได้เฉพาะกับแหล่งข้อมูลที่มีชุดอินพุตไฟล์

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

เรียกข้อมูลการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

แสดงรายการการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

อัปเดตการกำหนดค่าแหล่งข้อมูลที่มีอยู่ ระบบจะลบช่องที่ตั้งค่าไว้ในมาสก์การอัปเดตแต่ไม่ได้ระบุไว้ในทรัพยากร

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

CreateDataSourceRequest

ข้อความคำขอสำหรับเมธอด CreateDataSource

ช่อง
parent

string

ต้องระบุ บัญชีที่จะสร้างแหล่งข้อมูลนี้ รูปแบบ: accounts/{account}
data_source

DataSource

ต้องระบุ แหล่งข้อมูลที่จะสร้าง

DataSource

แหล่งข้อมูลสำหรับบัญชี Merchant Center

ช่อง
name

string

ตัวระบุ ชื่อของแหล่งข้อมูล รูปแบบ: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

เอาต์พุตเท่านั้น รหัสแหล่งข้อมูล
display_name

string

ต้องระบุ ชื่อแหล่งข้อมูลที่แสดงใน UI ของ Merchant Center
input

Input

เอาต์พุตเท่านั้น กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล การตั้งค่าบางอย่างอาจใช้งานไม่ได้ ทั้งนี้ขึ้นอยู่กับอินพุต คุณสร้างได้โดยใช้ API เฉพาะแหล่งข้อมูลทั่วไปเท่านั้น
file_input

FileInput

ไม่บังคับ ระบบจะใช้ช่องนี้เมื่อมีการจัดการข้อมูลผ่านไฟล์เท่านั้น
ช่องการรวม Type ประเภทแหล่งข้อมูล Type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
primary_product_data_source

PrimaryProductDataSource

ต้องระบุ แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
supplemental_product_data_source

SupplementalProductDataSource

ต้องระบุ แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
local_inventory_data_source

LocalInventoryDataSource

ต้องระบุ แหล่งข้อมูลสินค้าคงคลังในร้าน
regional_inventory_data_source

RegionalInventoryDataSource

ต้องระบุ แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค
promotion_data_source

PromotionDataSource

ต้องระบุ แหล่งข้อมูลโปรโมชัน

อินพุต

กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล ระบบอาจไม่รองรับการตั้งค่าบางอย่าง ทั้งนี้ขึ้นอยู่กับอินพุต

Enum
INPUT_UNSPECIFIED ไม่ได้ระบุอินพุต
API แสดงแหล่งข้อมูลที่ระบุข้อมูลผ่าน API เป็นหลัก
FILE หมายถึงแหล่งข้อมูลที่มีการให้ข้อมูลผ่านอินพุตไฟล์เป็นหลัก ข้อมูลยังคงให้ผ่าน API ได้
UI

แหล่งข้อมูลสำหรับผลิตภัณฑ์ที่เพิ่มลงใน Merchant Center โดยตรง

และไม่สามารถสร้างหรืออัปเดตแหล่งข้อมูลประเภทนี้ผ่าน API นี้ แต่จะใช้ UI ของ Merchant Center ได้เท่านั้น

แหล่งข้อมูลประเภทนี้เป็นแบบอ่านอย่างเดียว
AUTOFEED วิธีนี้เรียกอีกอย่างว่าฟีดอัตโนมัติซึ่งใช้สร้างข้อมูลผลิตภัณฑ์โดยอัตโนมัติ คุณเปิดหรือปิดใช้แหล่งข้อมูลประเภทนี้ได้ผ่านกลุ่มบัญชี

DeleteDataSourceRequest

ข้อความคำขอสำหรับเมธอด DeleteDataSource

ช่อง
name

string

ต้องระบุ ชื่อของแหล่งข้อมูลที่จะลบ รูปแบบ: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

ข้อความคำขอสำหรับเมธอด FetchDataSource

ช่อง
name

string

ต้องระบุ ชื่อของทรัพยากรแหล่งข้อมูลที่จะดึงข้อมูล รูปแบบ: accounts/{account}/dataSources/{datasource}

FileInput

ข้อมูลเฉพาะสำหรับแหล่งข้อมูลไฟล์ ช่องนี้จะว่างเปล่าสําหรับอินพุตแหล่งข้อมูลอื่นๆ

ช่อง
fetch_settings

FetchSettings

ไม่บังคับ เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล ซึ่งมีการตั้งค่าสำหรับอินพุตไฟล์ FETCH และ GOOGLE_SHEETS ช่องที่ต้องกรอกจะแตกต่างกันไปตามความถี่ในการดึงข้อมูล
file_name

string

ไม่บังคับ ชื่อไฟล์ของแหล่งข้อมูล จำเป็นสำหรับอินพุตไฟล์ UPLOAD ประเภท
file_input_type

FileInputType

เอาต์พุตเท่านั้น ประเภทของอินพุตไฟล์

FetchSettings

เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล

ช่อง
enabled

bool

ไม่บังคับ เปิดใช้หรือหยุดกำหนดการเรียกข้อมูลชั่วคราว
day_of_month

int32

ไม่บังคับ วันของเดือนที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล (1-31) ช่องนี้ตั้งค่าได้เฉพาะความถี่รายเดือนเท่านั้น
time_of_day

TimeOfDay

ไม่บังคับ ชั่วโมงของวันที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ระบบไม่รองรับนาทีและวินาทีและระบบจะไม่สนใจ
day_of_week

DayOfWeek

ไม่บังคับ วันของสัปดาห์ที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ตั้งค่าช่องนี้สำหรับความถี่รายสัปดาห์เท่านั้น
time_zone

string

ไม่บังคับ เขตเวลาที่ใช้สำหรับกำหนดการ UTC โดยค่าเริ่มต้น เช่น "America/Los_Angeles"
frequency

Frequency

ต้องระบุ ความถี่ที่อธิบายกำหนดการเรียกข้อมูล
fetch_uri

string

ไม่บังคับ URL ที่สามารถดึงข้อมูลไฟล์แหล่งข้อมูลได้ Google Merchant Center รองรับการอัปโหลดที่ตั้งเวลาไว้อัตโนมัติโดยใช้โปรโตคอล HTTP, HTTPS หรือ SFTP ดังนั้นค่าจะต้องเป็นลิงก์ที่ถูกต้องโดยใช้โปรโตคอล 1 ใน 3 รายการข้างต้น เปลี่ยนแปลงไม่ได้สำหรับไฟล์ Google ชีต
username

string

ไม่บังคับ ชื่อผู้ใช้ที่ไม่บังคับสำหรับ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] ใช้สำหรับการส่งแหล่งข้อมูลผ่าน SFTP
password

string

ไม่บังคับ รหัสผ่านที่ไม่บังคับสำหรับ [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

string

ต้องระบุ ชื่อของแหล่งข้อมูลที่จะดึงข้อมูล รูปแบบ: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

ข้อความคําขอสำหรับเมธอด ListDataSources

ช่อง
parent

string

ต้องระบุ บัญชีที่จะแสดงแหล่งข้อมูล รูปแบบ: accounts/{account}
page_size

int32

ไม่บังคับ จำนวนแหล่งข้อมูลสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ ค่าสูงสุดคือ 1,000 ค่าที่มากกว่า 1000 จะถูกเปลี่ยนเป็น 1000 หากไม่ระบุ ระบบจะแสดงผลจำนวนแหล่งข้อมูลสูงสุด
page_token

string

ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการโทร ListDataSources ก่อนหน้า โปรดระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ ListDataSources ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ

ListDataSourcesResponse

ข้อความตอบกลับสำหรับเมธอด ListDataSources

ช่อง
data_sources[]

DataSource

แหล่งข้อมูลจากบัญชีที่ระบุ
next_page_token

string

โทเค็นซึ่งสามารถส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไป หากเว้นช่องนี้ไว้ จะไม่มีหน้าลำดับต่อมา

LocalInventoryDataSource

แหล่งข้อมูลสินค้าคงคลังในร้าน

ช่อง
feed_label

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่แสดงสินค้าคงคลังในร้าน

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด
content_language

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังในร้าน

PrimaryProductDataSource

แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์

ช่อง
channel

Channel

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุประเภทของแชแนลของแหล่งข้อมูล
countries[]

string

ไม่บังคับ ประเทศที่อาจแสดงสินค้า แสดงเป็นรหัสเขตแดน CLDR
feed_label

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุในระดับแหล่งข้อมูล

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด

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

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

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล

ต้องตั้งค่าทั้ง feedLabel และ contentLanguage หรือไม่ตั้งค่า ยกเลิกการตั้งค่าช่องนี้ได้สำหรับแหล่งข้อมูลที่ไม่มีอินพุตไฟล์เท่านั้น

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

ช่อง

แชแนลแหล่งข้อมูล

แชแนลใช้เพื่อแยกแหล่งข้อมูลสำหรับประเภทธุรกิจที่แตกต่างกัน

Enum
CHANNEL_UNSPECIFIED ไม่ได้ระบุ
ONLINE_PRODUCTS ผลิตภัณฑ์ออนไลน์
LOCAL_PRODUCTS ผลิตภัณฑ์ในร้าน
PRODUCTS แหล่งข้อมูลแบบรวมสำหรับผลิตภัณฑ์ทั้งในท้องถิ่นและออนไลน์

PromotionDataSource

แหล่งข้อมูลโปรโมชัน

ช่อง
target_country

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR

โปรโมชันมีให้บริการเฉพาะในประเทศที่เลือกเท่านั้น
content_language

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล

RegionalInventoryDataSource

แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค

ช่อง
feed_label

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่ระบุสินค้าคงคลังระดับภูมิภาค

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด
content_language

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังระดับภูมิภาค

SupplementalProductDataSource

แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์

ช่อง
feed_label

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุในระดับแหล่งข้อมูล

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด

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

หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว
content_language

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล

ต้องตั้งค่าทั้ง feedLabel และ contentLanguage หรือไม่ตั้งค่า ยกเลิกการตั้งค่าช่องนี้ได้สำหรับแหล่งข้อมูลที่ไม่มีอินพุตไฟล์เท่านั้น

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

UpdateDataSourceRequest

ข้อความคำขอสำหรับเมธอด UpdateDataSource

ช่อง
data_source

DataSource

ต้องระบุ ทรัพยากรแหล่งข้อมูลที่จะอัปเดต
update_mask

FieldMask

ต้องระบุ รายการฟิลด์แหล่งข้อมูลที่จะอัปเดต

ระบบจะลบช่องที่ระบุในมาสก์การอัปเดตโดยไม่ระบุค่าในเนื้อหาออกจากแหล่งข้อมูล

ไม่รองรับการระบุค่า "*" พิเศษสําหรับการแทนที่แหล่งข้อมูลแบบเต็ม