การเรียก API โดยตรง

แนวทางนี้ในการโต้ตอบกับ Merchant API คือการส่งคำขอไปยังปลายทาง API โดยตรง ซึ่งโดยปกติจะส่งผ่าน HTTP(S) คุณต้องจัดการด้วยตนเองในส่วนต่างๆ เช่น การสร้างเนื้อหาคำขอ การตั้งค่าส่วนหัว (รวมถึงการตรวจสอบสิทธิ์) และการแยกวิเคราะห์การตอบกลับ

ขั้นตอนที่ 1 ลงทะเบียนในฐานะนักพัฒนาซอฟต์แวร์

หากต้องการใช้ Merchant API คุณต้องลงทะเบียนข้อมูลติดต่อของนักพัฒนาซอฟต์แวร์

การลงทะเบียนจะดำเนินการต่อไปนี้

  • สร้างผู้ติดต่อด้านเทคนิคสำหรับบัญชี Merchant Center โดยกำหนด บทบาท API developer ให้กับผู้ใช้ ซึ่งจะช่วยให้ Google ส่งข้อมูลอัปเดตที่สำคัญเกี่ยวกับ API และฟีเจอร์ที่นักพัฒนาซอฟต์แวร์ใช้โดยเฉพาะ เช่น ประกาศการให้บริการและข้อมูลเกี่ยวกับฟีเจอร์ใหม่ๆ ซึ่งอาจไม่น่าสนใจสำหรับผู้ที่ไม่ใช่นักพัฒนาซอฟต์แวร์
  • ช่วยให้คุณทำงานกับบัญชีผู้ขายหลายบัญชีได้โดยไม่ต้องลงทะเบียนหลายครั้ง เมื่อคุณลงทะเบียน ระบบจะเชื่อมโยงรหัสโปรเจ็กต์ Google Cloud ที่ใช้ในการตรวจสอบสิทธิ์กับ Merchant API กับบัญชี Merchant Center ของคุณ ซึ่งมีผู้ติดต่อด้านเทคนิค (API developers) วิธีนี้จะช่วยให้คุณได้รับข้อมูลอัปเดตที่สำคัญสำหรับบัญชีผู้ขายทั้งหมดที่คุณจัดการ ตราบใดที่การตรวจสอบสิทธิ์ดำเนินการด้วยโปรเจ็กต์ Google Cloud ที่ลงทะเบียนไว้

เมื่อลงทะเบียน โปรดปฏิบัติตามข้อกำหนดเบื้องต้นและข้อจำกัดที่ระบุไว้โดยละเอียดที่ การลงทะเบียน

หากต้องการลงทะเบียนโดยใช้วิธี developerRegistration.registerGcp คุณสามารถเริ่มต้นด้วยตัวอย่างนี้ โดยแทนที่ {DEVELOPER_EMAIL} ด้วย อีเมลที่เหมาะสมในเนื้อหาคำขอ

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

การเรียกใช้ที่สำเร็จจะแสดงผลทรัพยากร DeveloperRegistration ซึ่งยืนยันการลิงก์ระหว่างโปรเจ็กต์กับบัญชีของคุณ

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

ขั้นตอนที่ 2 จัดการผู้ติดต่อและสิทธิ์ของนักพัฒนาซอฟต์แวร์

เมื่อคุณลงทะเบียน

  • หากอีเมลเป็นของผู้ใช้ในบัญชี Merchant Center ระบบจะกำหนดบทบาท API_DEVELOPER ให้ผู้ใช้รายดังกล่าว
  • หากอีเมลไม่ใช่ของผู้ใช้ที่มีอยู่ ระบบจะส่งคำเชิญไปยังอีเมลดังกล่าว ผู้รับต้องยอมรับคำเชิญเพื่อเพิ่มเป็นผู้ใช้ใหม่ที่มีบทบาท API_DEVELOPER

หลังจากลงทะเบียนครั้งแรก เราขอแนะนำให้คุณเพิ่มนักพัฒนาซอฟต์แวร์หลายคนและให้สิทธิ์เข้าถึงเพิ่มเติมแก่บุคคลเหล่านั้น

ขั้นตอนที่ 2ก ให้สิทธิ์เพิ่มเติม

คุณต้องมีบทบาท API_DEVELOPER เพื่อรับการแจ้งเตือนที่สำคัญ แต่บทบาทนี้มีสิทธิ์น้อยที่สุดภายใน Merchant Center หากต้องการอนุญาตให้ผู้ใช้รายนี้ทำการเรียกใช้ API อื่นๆ หรือจัดการการตั้งค่าใน UI ของ Merchant Center คุณต้องกำหนดบทบาทเพิ่มเติมให้ผู้ใช้ เช่น STANDARD หรือ ADMIN ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ ประเภทการเข้าถึง

คุณสามารถอัปเดตสิทธิ์เข้าถึงของผู้ใช้ด้วยวิธี accounts.users.patch

ตัวอย่างต่อไปนี้แสดงวิธีอัปเดตผู้ใช้เพื่อให้ผู้ใช้มีบทบาท ADMIN และ API_DEVELOPER ซึ่งจะช่วยให้ผู้ใช้จัดการบัญชีได้อย่างเต็มที่และจะได้รับการสื่อสารที่เกี่ยวข้องกับ API ด้วย

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

ขั้นตอนที่ 2ข เพิ่มนักพัฒนาซอฟต์แวร์สำรอง

คุณควรเพิ่มนักพัฒนาซอฟต์แวร์สำรองอย่างน้อย 1 คนเพื่อป้องกันไม่ให้การเข้าถึง API หยุดชะงักหากผู้ติดต่อหลักของนักพัฒนาซอฟต์แวร์ออกจากองค์กร

คุณสามารถเพิ่มผู้ใช้ด้วยวิธี accounts.users.create หรืออัปเดตผู้ใช้ที่มีอยู่ด้วยวิธี accounts.users.patch เราขอแนะนำให้กำหนดบทบาท ADMIN และ API_DEVELOPER ให้ผู้ใช้รายนี้

ขั้นตอนที่ 3 สร้างแหล่งข้อมูลผลิตภัณฑ์หลัก

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

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

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

แทนที่ {ACCOUNT_ID} ด้วยรหัสของบัญชี Merchant Center ที่คุณสร้างขึ้น

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

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

คัดลอกค่าของช่อง name คุณจะต้องใช้ค่านี้เพื่อแทรกผลิตภัณฑ์

คุณดูแหล่งข้อมูลนี้ได้ใน UI ของ Merchant Center ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ ดู วิธีค้นหาแท็บแหล่งข้อมูล

ขั้นตอนที่ 4 แทรกผลิตภัณฑ์

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

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

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

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "brand": "New brand",
    "gender": "MALE"
  }
}

รหัสผลิตภัณฑ์สำหรับผลิตภัณฑ์ที่สร้างขึ้นใหม่คือ en~US~tshirt-123 คุณสามารถใช้ วิธี accounts.products.get เพื่อดึงข้อมูลรายละเอียดเกี่ยวกับผลิตภัณฑ์นี้ นอกจากนี้ คุณยังใช้ UI ของ Merchant Center เพื่อดูผลิตภัณฑ์นี้ได้ด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับการดูข้อมูลผลิตภัณฑ์ ได้ที่ ภาพรวมของผลิตภัณฑ์ใน Merchant Center