ภาพรวมของ Programs API

โปรแกรมช่วยให้คุณควบคุมการโปรโมตผลิตภัณฑ์และปรับปรุงฟีเจอร์ของบัญชีในแพลตฟอร์มต่างๆ ของ Google ได้

ตัวอย่างที่เห็นได้ชัดคือโปรแกรมข้อมูลผลิตภัณฑ์ที่แสดงฟรี ซึ่งช่วยให้ผลิตภัณฑ์จากร้านค้าออนไลน์ของคุณแสดงใน Google ได้โดยไม่เสียค่าใช้จ่าย

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

หากต้องการเรียกดู เปิดใช้ และปิดใช้โปรแกรม คุณสามารถใช้วิธีต่อไปนี้

แสดงรายการโปรแกรมทั้งหมด

หากต้องการเรียกข้อมูลโปรแกรมทั้งหมดของบัญชี ให้ใช้เมธอด accounts.programs.list

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

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

ตัวอย่างการตอบกลับจากคำขอที่สำเร็จมีดังนี้

{
  "programs": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
      "documentationUri": "{URI}",
      "state": "{ACCOUNT_STATE}",
      "unmetRequirements": [
        {
          "title": "{TITLE}",
          "documentationUri": "{URI}",
          "affectedRegionCodes": [
            "{REGION_CODE}"
          ]
        }
      ]
    }
  ]
}

เรียกข้อมูลโปรแกรมเดียว

หากต้องการเรียกข้อมูลโปรแกรมที่เฉพาะเจาะจง ให้ใช้เมธอด accounts.programs.get

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

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings

ตัวอย่างการตอบกลับจากคำขอที่สำเร็จมีดังนี้

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}",
  "unmetRequirements": [
    {
      "title": "{TITLE}",
      "documentationUri": "{URI}",
      "affectedRegionCodes": [
        "{REGION_CODE}"
      ]
    }
  ]
}

เปิดใช้โปรแกรม

หากต้องการเปิดใช้การเข้าร่วมโปรแกรมที่ระบุสำหรับบัญชี ให้ใช้วิธี accounts.programs.enable คุณต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบจึงจะใช้สิทธิ์นี้ได้

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

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings:enable

ตัวอย่างการตอบกลับจากคำขอที่สำเร็จมีดังนี้

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}",
  "unmetRequirements": [
    {
      "title": "{TITLE}",
      "documentationUri": "{URI}",
      "affectedRegionCodes": [
        "{REGION_CODE}"
      ]
    }
  ]
}

ปิดใช้โปรแกรม

หากต้องการปิดใช้การเข้าร่วมโปรแกรมที่ระบุสำหรับบัญชี ให้ใช้วิธีการ accounts.programs.disable คุณต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบจึงจะใช้สิทธิ์นี้ได้

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

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/programs/free-listings:disable

ตัวอย่างการตอบกลับจากคำขอที่สำเร็จมีดังนี้

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}"
}