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

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

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

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

การลงทะเบียนจะช่วยให้คุณทำสิ่งต่อไปนี้ได้

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

ขั้นตอนที่ 2b เพิ่มนักพัฒนาแอปสำรอง

คุณควรเพิ่มนักพัฒนาแอปสำรองอย่างน้อย 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 เพื่อดูผลิตภัณฑ์นี้ได้ด้วย ดูดูข้อมูลผลิตภัณฑ์

ก่อนหน้า
Overview
ถัดไป
Client libraries