نمای کلی برنامه های API ، نمای کلی برنامه های API

برنامه ها به شما امکان می دهند تبلیغات محصولات خود را کنترل کنید و ویژگی های حساب خود را در سطوح مختلف 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}"
}
،

برنامه ها به شما امکان می دهند تبلیغات محصولات خود را کنترل کنید و ویژگی های حساب خود را در سطوح مختلف 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}"
}