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

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

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

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

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

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

ขั้นตอนที่ 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