เริ่มต้นใช้งาน Merchant API

หน้านี้อธิบายวิธีสร้างบัญชี Merchant Center และอัปโหลด ผลิตภัณฑ์ตัวอย่างโดยใช้ Merchant API

ก่อนเริ่มต้น

เปิดใช้ Merchant API ในโปรเจ็กต์ Google Cloud

หากคุณใช้การผสานรวม API ใน Apps Script โดยใช้บริการเนื้อหา Shopping ระบบจะสร้างโปรเจ็กต์ Google Cloud เริ่มต้นและเปิดใช้บริการ Merchant API โดยอัตโนมัติ อย่างไรก็ตาม คุณยังคงต้องลงทะเบียนเป็นนักพัฒนาแบบครั้งเดียวก่อนใช้ Merchant API ดูข้อมูลเพิ่มเติมได้ที่การใช้ บริการ Merchant API ใน Apps Script

ไปที่ Google Cloud

สร้างบัญชี

หากต้องการใช้ Merchant API คุณต้องมีบัญชี Merchant Center หากต้องการสร้างบัญชี โปรดดูหัวข้อเริ่มต้นใช้งาน Merchant Center

ไปที่ Merchant Center

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

หากต้องการใช้ Merchant API คุณต้องสร้างลิงก์ระหว่างโปรเจ็กต์ Google Cloud กับบัญชี Merchant Center หลัก การลงทะเบียนแบบครั้งเดียวนี้ จำเป็นสำหรับโปรเจ็กต์ Google Cloud ทุกโปรเจ็กต์ที่คุณใช้กับ Merchant API

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

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

ลงทะเบียนโปรเจ็กต์ Google Cloud

หากต้องการลงทะเบียน ให้เรียกใช้เมธอด developerRegistration.registerGcp การเรียกนี้จะลิงก์โปรเจ็กต์ Google Cloud ที่คุณใช้ในการเรียกกับบัญชี Merchant Center ที่คุณระบุในคำขอ

ในเนื้อหาคำขอ คุณต้องระบุอีเมลของนักพัฒนาแอปเพื่อใช้เป็น ผู้ติดต่อด้านเทคนิค อีเมลนี้ต้องเชื่อมโยงกับบัญชี Google (บัญชี Google Workspace หรือบัญชี Gmail) เช่น sampleuser@gmail.com ใช้บัญชีบริการไม่ได้เนื่องจากเป็นบัญชีที่ไม่ใช่ของบุคคลซึ่งมีไว้สำหรับการเข้าถึงแบบเป็นโปรแกรมและไม่ใช่การสื่อสารกับนักพัฒนาแอป

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

ตัวอย่างคำขอมีดังนี้

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

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

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

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

จัดการรายชื่อติดต่อและสิทธิ์ของนักพัฒนาแอป

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

ให้สิทธิ์เพิ่มเติม

คุณต้องมีบทบาท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"
  ]
}

เพิ่มนักพัฒนาแอปสำรอง

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

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

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

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

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

{
  "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 ดูข้อมูลเพิ่มเติมได้ที่วิธีค้นหาแท็บแหล่งข้อมูล

แทรกผลิตภัณฑ์

หากต้องการแทรกผลิตภัณฑ์ตัวอย่างลงในบัญชี ให้เรียกใช้คำขอต่อไปนี้

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

แทนที่ {DATASOURCE_NAME} ด้วยค่าที่คุณคัดลอกไว้ ก่อนหน้านี้

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

{
  "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",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

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