Panoramica della sottoAPI Programs

I programmi ti consentono di controllare la promozione dei tuoi prodotti e di migliorare le funzionalità del tuo account su varie piattaforme Google.

Un tipico esempio è il programma delle schede di prodotto senza costi, che consente di mostrare i prodotti del tuo negozio online su Google senza costi.

La sottoAPI Programs ti consente di recuperare e aggiornare la tua partecipazione a tutti i programmi Shopping disponibili.

Per recuperare, attivare e disattivare i programmi, puoi utilizzare i seguenti metodi:

Elenca tutti i programmi

Per recuperare tutti i programmi per l'account, utilizza il metodo accounts.programs.list.

Ecco una richiesta di esempio:

HTTP

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

cURL

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

Ecco un esempio di risposta di una richiesta andata a buon fine:

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

Recuperare un singolo programma

Per recuperare un programma specifico, utilizza il metodo accounts.programs.get.

Ecco una richiesta di esempio:

HTTP

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

cURL

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

Ecco un esempio di risposta di una richiesta andata a buon fine:

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

Attivare un programma

Per attivare la partecipazione al programma specificato per l'account, utilizza il metodo accounts.programs.enable. Per eseguire questa autorizzazione, devi disporre dell'accesso amministrativo.

Ecco una richiesta di esempio:

HTTP

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

cURL

  curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1beta/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

Ecco un esempio di risposta di una richiesta andata a buon fine:

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

Disattivare un programma

Per disattivare la partecipazione al programma specificato per l'account, utilizza il metodo accounts.programs.disable. Per eseguire questa autorizzazione, devi disporre dell'accesso amministrativo.

Ecco una richiesta di esempio:

HTTP

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

cURL

  curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1beta/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

Ecco un esempio di risposta di una richiesta andata a buon fine:

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