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

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

Content API for Shopping ช่วยให้คุณสร้างแหล่งข้อมูลหลักได้เท่านั้น คุณสามารถสร้างแหล่งข้อมูลประเภทต่อไปนี้ได้ด้วย Merchant Data Sources 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

ตัวอย่างคำขอต่อไปนี้แสดงวิธีสร้างแหล่งข้อมูลผลิตภัณฑ์หลัก

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

แทนที่ค่าต่อไปนี้

  • {ACCOUNT_ID}: ตัวระบุที่ไม่ซ้ำของบัญชี Merchant Center
  • {DISPLAY_NAME}: ชื่อที่แสดงของแหล่งข้อมูล
  • {CONTENT_LANGUAGE}: รหัสภาษา 2 ตัวอักษรตามมาตรฐาน ISO 639-1 ของผลิตภัณฑ์ในแหล่งข้อมูล
  • {FEED_LABEL}: ป้ายกํากับฟีดของแหล่งข้อมูล
  • {COUNTRY}: รหัสเขตแดน CLDR ของประเทศเป้าหมายของผลิตภัณฑ์ที่จะอัปโหลดโดยใช้แหล่งข้อมูล

หลังจากเรียกใช้คําขอสําเร็จแล้ว คุณจะเห็นการตอบกลับต่อไปนี้

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างแหล่งข้อมูลได้ที่เมธอด 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 หากต้องการดูผลลัพธ์ของการดึงข้อมูลแหล่งข้อมูลที่คำนวณแบบไม่พร้อมกันครั้งล่าสุดเมื่อการประมวลผลแหล่งข้อมูลเสร็จสิ้น ให้ใช้ตัวระบุชื่อ latest

GET https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

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

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