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

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

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

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

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

ไปที่ Google Cloud

สร้างบัญชี

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

ไปที่ Merchant Center

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

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

  1. ลิงก์ Merchant Center กับโปรเจ็กต์ Google Cloud: ระบบจะอนุมัติลิงก์โดยอัตโนมัติ เนื่องจากผู้เรียกมีโทเค็นการเข้าถึงหรือคีย์ API ที่ถูกต้องจากโปรเจ็กต์ Google Cloud และเป็นผู้ใช้ที่ได้รับอนุญาตของบัญชี Merchant Center

  2. เพิ่มผู้ใช้ API Developer ลงในบัญชี Merchant Center: การลงทะเบียน API จะเพิ่มผู้ใช้ API Developer ลงในบัญชี Merchant Center หากมีผู้ใช้ อยู่แล้ว ผู้ใช้จะได้รับสิทธิ์เข้าถึงประเภทใหม่ ในกรณีที่เป็นผู้ใช้ใหม่ ผู้ใช้จะได้รับคำเชิญทางอีเมลของ Merchant Center

เราขอแนะนำให้คุณใช้วิธี accounts.users.create เพื่อเพิ่มนักพัฒนาซอฟต์แวร์ API เพิ่มเติมหรือสำรองเพื่อยืนยันว่าในกรณีที่ บุคคลดังกล่าวออกจากองค์กรหรือถูกลบ คุณจะยังคงมีการลงทะเบียนนักพัฒนาซอฟต์แวร์ที่ถูกต้อง

หลังจากลงทะเบียนแล้ว คุณจะดูสถานะการลงทะเบียนได้โดยใช้ GetDeveloperRegistration หรือยกเลิกการลงทะเบียนโดยใช้ UnregisterGCP

การโทรลงทะเบียนคือ

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

{
  developer_email:"example-email@example.com"
}

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

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

หลังจากลงทะเบียนนักพัฒนา API แล้ว คุณจะใช้วิธีการ accounts.users.patch เพื่อมอบบทบาทเพิ่มเติม เช่น STANDARD และ ADMIN ให้กับนักพัฒนา API ได้

รับรหัสบัญชี

คุณดูรหัสบัญชีได้โดยใช้เมธอด accounts.list

คุณสามารถใช้โปรแกรมสำรวจ Google APIs เพื่อเรียกใช้คำขอ Merchant API โปรแกรมสำรวจ API ใช้ Google OAuth 2.0 สำหรับ การตรวจสอบสิทธิ์ ก่อนที่จะเรียกใช้คำขอ ให้ตรวจสอบว่าได้เลือกช่องทำเครื่องหมาย Google OAuth 2.0 แล้ว

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

คำขอต่อไปนี้แสดงวิธีดึงข้อมูลรหัสบัญชี

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

หรือ

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

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

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

คัดลอก {ACCOUNT_ID} เนื่องจากคุณจะต้องใช้เพื่อเรียกใช้คำขออื่นๆ

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

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

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

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "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": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

ระบบจะใช้เวลาสักครู่เพื่อให้แหล่งข้อมูลที่สร้างขึ้นพร้อมสำหรับการแทรกผลิตภัณฑ์

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

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

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

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

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

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

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

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

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

ก่อนหน้า
Launch status
ถัดไป
Overview