Обзор API программ,Обзор API программ

Программы позволяют вам контролировать продвижение ваших продуктов и расширять возможности вашей учетной записи на различных платформах Google.

Типичным примером этого является программа бесплатных списков товаров , которая позволяет бесплатно показывать товары из вашего интернет-магазина в Google.

API программ позволяет вам получать и обновлять сведения о вашем участии во всех доступных программах покупок.

Для получения, включения и отключения программ вы можете использовать следующие методы:

• accounts.programs.list
• accounts.programs.get
• accounts.programs.enable
• accounts.programs.disable

Список всех программ

Чтобы получить все программы для учетной записи, используйте метод 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}"
}