Creare e aggiornare le regioni

Nell'API Merchant puoi utilizzare le regioni geografiche come target per i servizi correlati alla accounts.products.regionalInventories risorsa. Puoi definire le regioni come raccolte di codici postali o, in alcuni paesi, utilizzando geotarget predefiniti. Per ulteriori informazioni, consulta Configurare le regioni.

Per creare e aggiornare le regioni, puoi utilizzare i seguenti metodi:

Recuperare una regione

Per recuperare una regione definita nel tuo account Merchant Center, utilizza il accounts.regions.get metodo.

Ecco una richiesta di esempio:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions/234567

Ecco una risposta di esempio a una chiamata riuscita:

HTTP/1.1 200

{
  "name": "accounts/125222396/regions/234567",
  "displayName": "Canada",
  "postalCodeArea": {
    "regionCode": "CA",
    "postalCodes": [
      {
        "begin": "L6A"
      }
    ]
  }

Elencare tutte le regioni

Per elencare le regioni nel tuo account Merchant Center, utilizza il accounts.regions.list metodo.

Ecco una richiesta di esempio:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions?pageSize=100

Ecco una risposta di esempio a una chiamata riuscita:

HTTP/1.1 200

{
  "regions": [
    {
      "name": "accounts/125222396/regions/234567",
      "displayName": "Canada",
      "postalCodeArea": {
        "regionCode": "CA",
        "postalCodes": [
          {
            "begin": "L6A"
          }
        ]
      },
      "regionalInventoryEligible": true,
      "shippingEligible": true
    },
    {
      "name": "accounts/125222396/regions/Inline region",
      "displayName": "Inline region",
      "postalCodeArea": {
        "regionCode": "CA",
        "postalCodes": [
          {
            "begin": "M7B"
          }
        ]
      },
      "regionalInventoryEligible": false,
      "shippingEligible": true
    },
  ]
}

Inserire una regione

Per inserire una definizione di regione nel tuo account Merchant Center, utilizza il accounts.regions.create metodo. L'esecuzione di questo metodo richiede l'accesso come amministratore.

Ecco una richiesta di esempio:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=987654

{
  "displayName": "TestRegion",
  "name": "987654",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98109"
      }
    ],
    "regionCode": "US"
  }
}

Ecco una risposta di esempio a una chiamata riuscita:

{
     "name": "accounts/102959835/regions/987654",
  "displayName": "TestRegion",
  "postalCodeArea": {
    "regionCode": "US",
    "postalCodes": [
      {
        "begin": "98109"
      }
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": true
}

Per creare una nuova regione con AreaCode:

Ecco una richiesta di esempio:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=168888 HTTP/1.1

{
  "displayName": "WA_test",
  "name": "168888",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20101
    ]
  }
}

Ecco una risposta di esempio a una chiamata riuscita:

{
  "name": "accounts/102959835/regions/168888",
  "displayName": "WA_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      "20101"
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": false
}

Per aggiornare displayName e GeoTargetCriteriaIds per la regione creata:

Ecco una richiesta di esempio:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea HTTP/1.1

{
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20100
    ]
  }
}

Ecco una risposta di esempio a una chiamata riuscita:

HTTP/1.1 200

{
  "name": "accounts/102959835/regions/168888",
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      "20100"
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": false
}

Aggiornare una regione

Per aggiornare una definizione di regione nel tuo account Merchant Center, utilizza il accounts.regions.patch metodo. L'esecuzione di questo metodo richiede l'accesso come amministratore.

Ecco una richiesta di esempio:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/987654?updateMask=displayName%2CpostalCodeArea HTTP/1.1

Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json

{
  "displayName": "Test",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98108"
      }
    ],
    "regionCode": "US"
  }
}

Ecco una risposta di esempio a una chiamata riuscita:

{
  "name": "accounts/102959835/regions/987654",
  "displayName": "Test",
  "postalCodeArea": {
    "regionCode": "US",
    "postalCodes": [
      {
        "begin": "98108"
      }
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": true
}

Eliminare una regione

Per eliminare una definizione di regione dal tuo account Merchant Center, utilizza il accounts.regions.delete metodo. L'esecuzione di questo metodo richiede l'accesso come amministratore.

Ecco una richiesta di esempio:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/987654 HTTP/1.1

Ecco una risposta di esempio a una chiamata riuscita:

HTTP/1.1 200
{}

Operazioni batch

Se gestisci più regioni, l'API Merchant fornisce endpoint batch che ti consentono di creare, aggiornare ed eliminare fino a 100 regioni in una singola chiamata. Per ulteriori informazioni, consulta Gestire il batching delle regioni.

Indietro
Manage Terms of Service
Avanti
Manage region batching