نمای کلی زیرمیانای برنامه‌سازی کاربردی «برنامه‌ها»

برنامه‌ها به شما امکان می‌دهند تبلیغ محصولاتتان را کنترل کنید و ویژگی‌های حسابتان را در سطوح مختلف Google بهبود دهید.

نمونه معمول این مورد برنامه فهرستگان‌های رایگان محصول است که امکان می‌دهد محصولات فروشگاه آنلاین شما بدون هزینه در سراسر Google نشان داده شود.

زیرمیانای برنامه‌سازی کاربردی «برنامه‌ها» به شما امکان می‌دهد مشارکت خود را در همه برنامه‌های خرید دردسترس بازیابی و به‌روز کنید.

برای بازیابی، فعال کردن، و غیرفعال کردن برنامه‌ها، می‌توانید از روش‌های زیر استفاده کنید:

فهرست کردن همه برنامه‌ها

برای بازیابی همه برنامه‌های حساب، از روش accounts.programs.list استفاده کنید.

در اینجا یک درخواست نمونه آورده شده است:

HTTP

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

cURL

  curl \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --compressed

در اینجا یک پاسخ نمونه از درخواست موفق آورده شده است:

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

بازیابی یک برنامه

برای بازیابی برنامه‌ای خاص، از روش accounts.programs.get استفاده کنید.

در اینجا یک درخواست نمونه آورده شده است:

HTTP

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

cURL

  curl \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listing?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --compressed

در اینجا یک پاسخ نمونه از درخواست موفق آورده شده است:

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

فعال کردن برنامه

برای فعال کردن مشارکت در برنامه مشخص‌شده برای حساب، از روش accounts.programs.enable استفاده کنید. برای اجرای این اجازه باید دسترسی سرپرست داشته باشید.

در اینجا یک درخواست نمونه آورده شده است:

HTTP

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

cURL

  curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listing:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

در اینجا یک پاسخ نمونه از درخواست موفق آورده شده است:

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

غیرفعال کردن برنامه

برای غیرفعال کردن مشارکت در برنامه مشخص‌شده برای حساب، از روش accounts.programs.disable استفاده کنید. برای اجرای این اجازه، باید دسترسی سرپرست داشته باشید.

در اینجا یک درخواست نمونه آورده شده است:

HTTP

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

cURL

  curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listing:disable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

در اینجا یک پاسخ نمونه از درخواست موفق آورده شده است:

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