Visão geral da API Programs

Com os programas, você pode controlar a promoção dos seus produtos e melhorar os recursos da sua conta em várias plataformas do Google.

Um exemplo típico disso é o programa de listagens de produtos sem custo financeiro, que permite que os itens da sua loja on-line sejam mostrados em todo o Google sem custos.

A API Programs permite que você recupere e atualize sua participação em todos os programas de compras disponíveis.

Para recuperar, ativar e desativar programas, use os seguintes métodos:

Listar todos os programas

Para recuperar todos os programas da conta, use o método accounts.programs.list.

Confira um exemplo de solicitação:

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

Confira um exemplo de resposta de uma solicitação bem-sucedida:

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

Recuperar um único programa

Para recuperar um programa específico, use o método accounts.programs.get.

Confira um exemplo de solicitação:

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

Confira um exemplo de resposta de uma solicitação bem-sucedida:

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

Ativar um programa

Para permitir a participação no programa especificado para a conta, use o método accounts.programs.enable. É necessário ter acesso de administrador para executar essa permissão.

Confira um exemplo de solicitação:

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

Confira um exemplo de resposta de uma solicitação bem-sucedida:

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

Desativar um programa

Para desativar a participação no programa especificado para a conta, use o método accounts.programs.disable. É necessário ter acesso de administrador para executar essa permissão.

Confira um exemplo de solicitação:

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

Confira um exemplo de resposta de uma solicitação bem-sucedida:

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