ภาพรวมของ API แหล่งข้อมูลผู้ขาย

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

Content API for Shopping ช่วยให้คุณสร้างแหล่งข้อมูลหลักได้เท่านั้น ด้วย API แหล่งข้อมูลผู้ขาย คุณสร้างแหล่งข้อมูลประเภทต่อไปนี้ได้

Content API for Shopping อนุญาตให้คุณจัดการแหล่งข้อมูลด้วยการป้อนข้อมูลไฟล์เท่านั้น Merchant API ช่วยให้คุณจัดการแหล่งข้อมูลด้วยอินพุตทั้งไฟล์และ API ได้

เมื่อใช้ Merchant Data Sources API คุณจะทำสิ่งต่อไปนี้ได้

  • สร้างแหล่งข้อมูลหลักใหม่ที่มี feedLabel และ contentLanguage ที่เฉพาะเจาะจง
  • สร้างแหล่งข้อมูลที่ไม่มีการตั้งค่าช่อง feedLabel และ contentLanguage การใช้แหล่งข้อมูลประเภทนี้ช่วยให้คุณกำหนดเป้าหมายผลิตภัณฑ์ไปยังหลายประเทศได้ เนื่องจากคุณสามารถแทรกผลิตภัณฑ์ที่มีfeedLabelและ contentLanguage ผสมผสานกันหลายรูปแบบลงในแหล่งข้อมูลเดียว
  • สร้างแหล่งข้อมูลเสริมเพื่อลิงก์กับแหล่งข้อมูลหลักที่มีอยู่
  • ตั้งกําหนดเวลาสําหรับแหล่งข้อมูลไฟล์
  • ลงทะเบียนบัญชีเพื่อการจัดการแหล่งข้อมูลโดยอัตโนมัติ
  • จัดการแหล่งข้อมูล API
  • จัดการกฎเริ่มต้นของแหล่งข้อมูลโดยใช้แหล่งข้อมูลผลิตภัณฑ์หลัก
  • ใช้แหล่งข้อมูลประเภทอื่นๆ เช่น โปรโมชัน

คุณใช้ Merchant API เพื่อแทรกผลิตภัณฑ์ในแหล่งข้อมูลที่มี ทั้งผลิตภัณฑ์ในท้องถิ่นและออนไลน์ ดูข้อมูลเพิ่มเติมเกี่ยวกับแชแนลแหล่งข้อมูลได้ที่แชแนล

ข้อกำหนดเบื้องต้น

  • บัญชีของคุณต้องได้รับการย้ายข้อมูลไปยังฟีดภาษาเดียว

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

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

สร้างแหล่งข้อมูลใหม่

แหล่งข้อมูลหลักคือแหล่งข้อมูลหลักสำหรับ Merchant Center พื้นที่โฆษณา คุณจะเพิ่มหรือนำผลิตภัณฑ์ออกได้โดยใช้แหล่งข้อมูลหลักเท่านั้น หากผลิตภัณฑ์ทุกรายการที่เพิ่มลงในแหล่งข้อมูลหลักมีคุณสมบัติตรงตามข้อกำหนดด้านข้อมูลและข้อกำหนดของการได้รับสิทธิ์ของ Merchant Center คุณก็ไม่จำเป็นต้องสร้างแหล่งข้อมูลอีก

หากต้องการสร้างแหล่งข้อมูลหลักใหม่ที่มี feedLabel และ contentLanguage ที่เฉพาะเจาะจง ให้ตั้งค่าช่อง feedLabel และ contentLanguage ในการกำหนดค่าเฉพาะประเภท สำหรับข้อมูลเพิ่มเติมเกี่ยวกับช่องเหล่านี้ ดู PrimaryProductDataSource

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างแหล่งข้อมูลได้ที่ accounts.dataSources.create

หากต้องการดูแหล่งข้อมูลที่สร้างขึ้นใหม่ ให้ใช้ accounts.dataSources.get หรือ accounts.dataSources.list

สร้างแหล่งข้อมูลหลักใหม่ที่ช่วยกำหนดเป้าหมายหลายประเทศ

หากต้องการสร้างฟีดหลักใหม่ที่ช่วยให้คุณกำหนดเป้าหมายหลายประเทศ ให้กำหนดค่าแหล่งข้อมูลโดยใช้ PrimaryProductDataSource และอย่าตั้งค่าฟิลด์ feedLabel และ contentLanguage

เมื่อใช้ Content API for Shopping จะสร้างแหล่งข้อมูล API เพียงแหล่งเดียวสำหรับ ให้ทำงานแทนคุณ เมื่อใช้ Merchant Data Sources API คุณจะมีแหล่งข้อมูล API ได้หลายแหล่ง โดยแหล่งข้อมูลบางแหล่งอาจไม่มีการตั้งค่าช่อง feedLabel และ contentLanguage

เฉพาะแหล่งข้อมูลที่มีอินพุต API เท่านั้นที่จะตั้งค่าฟิลด์ feedLabel และ contentLanguage ไม่ได้ ไฟล์ไม่รองรับแหล่งข้อมูลประเภทนี้ อินพุต

สร้างแหล่งข้อมูลเสริมและลิงก์กับแหล่งข้อมูลหลัก

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

คุณสามารถใช้แหล่งข้อมูลเสริมเพื่ออัปเดตข้อมูลผลิตภัณฑ์บางส่วนได้โดย การเพิ่มตัวระบุที่ไม่ซ้ำของแหล่งข้อมูลเป็นพารามิเตอร์การค้นหาเมื่อ การเรียกไปยัง accounts.productInputs.insert และ accounts.productInputs.delete คุณใช้ได้เฉพาะแหล่งข้อมูลเสริมในการอัปเดตผลิตภัณฑ์ที่มีอยู่

หากต้องการสร้างแหล่งข้อมูลเสริม ให้กําหนดค่าแหล่งข้อมูลโดยใช้ SupplementalProductDataSource จากนั้นลิงก์โดยอัปเดตฟิลด์ defaultRule ในแหล่งข้อมูลหลัก

แหล่งข้อมูลไฟล์เสริมต้องมีการตั้งค่าช่อง feedLabel และ contentLanguage แหล่งข้อมูล API เสริมต้องไม่มีการตั้งค่าฟิลด์ feedLabel และ contentLanguage เสมอ

ตั้งค่ากำหนดการสำหรับแหล่งข้อมูลไฟล์

หากต้องการตั้งเวลาฟีดไฟล์ ให้กําหนดค่าแหล่งข้อมูลเป็นแหล่งข้อมูลไฟล์โดยใช้ช่อง FileInput จากนั้นตั้งค่า fetchsettings โดยใช้ช่อง FileInput.FetchSettings

ลบแหล่งข้อมูล

หากต้องการลบแหล่งข้อมูลที่มีอยู่ออกจากบัญชี ให้ใช้ accounts.dataSources.delete

ดึงข้อมูลแหล่งข้อมูล

หากต้องการดึงข้อมูลไฟล์ที่กําหนดค่าไว้ในแหล่งข้อมูล ให้ใช้วิธี accounts.dataSources.fetch วิธีนี้จะดึงข้อมูลในแหล่งข้อมูลจากบัญชีของคุณโดยทันที วิธีการนี้ใช้ได้กับแหล่งข้อมูลที่มีการตั้งค่าการป้อนข้อมูลไฟล์เท่านั้น

รับแหล่งข้อมูล

หากต้องการเรียกข้อมูลการกําหนดค่าแหล่งข้อมูลสําหรับบัญชี ให้ใช้เมธอด accounts.dataSources.get

แสดงรายการแหล่งข้อมูล

หากต้องการแสดงรายการการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีของคุณ ให้ใช้ accounts.dataSources.list

แพตช์แหล่งข้อมูล

หากต้องการอัปเดตการกําหนดค่าของแหล่งข้อมูลที่มีอยู่ ให้ใช้วิธี accounts.dataSources.patch

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

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

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

การจัดการฟีดอัตโนมัติ

หากต้องการลงทะเบียนบัญชีเพื่อรับการจัดการแหล่งข้อมูลโดยอัตโนมัติ คุณต้องดำเนินการต่อไปนี้ ดังต่อไปนี้:

หลังจากที่บัญชีมีสิทธิ์ลงทะเบียนแล้ว คุณจะใช้ accounts.autofeedSettings.updateAutofeedSettings เพื่อเปิดใช้การจัดการแหล่งข้อมูลโดยอัตโนมัติ การเปิดใช้การจัดการแหล่งข้อมูลอัตโนมัติช่วยให้ Google เพิ่มผลิตภัณฑ์จากร้านค้าออนไลน์โดยอัตโนมัติและทำให้ผลิตภัณฑ์เป็นข้อมูลล่าสุดบนแพลตฟอร์มของ Google อยู่เสมอ

เรียกดูสถานะการอัปโหลดไฟล์

หากต้องการดูสถานะของแหล่งข้อมูลด้วยไฟล์ การดึงข้อมูล หรือสเปรดชีต ให้ทำดังนี้ สามารถเรียกเมธอด GET ของ accounts.dataSources.fileUploads service. เพื่อดูผลการดึงข้อมูลครั้งล่าสุดของแหล่งข้อมูลที่คํานวณ แบบไม่พร้อมกันเมื่อการประมวลผลแหล่งข้อมูลเสร็จสิ้น ให้ใช้ชื่อ ตัวระบุ latest

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

สถานะการอัปโหลดไฟล์อาจมีมุมมองโดยละเอียดของผลิตภัณฑ์ รวมถึง ปัญหาที่อาจเกิดขึ้น

โปรดทราบว่าสถานะการอัปโหลดไฟล์อาจไม่ปรากฏขึ้นหากไม่เคยอัปโหลดไฟล์ สถานะการอัปโหลดไฟล์อาจอยู่ในสถานะกำลังประมวลผลหากได้รับคำขอไม่นานหลังจากนั้น ระบบจะอัปโหลดไฟล์