Regionen erstellen und aktualisieren

In der Merchant API können Sie geografische Regionen als Ziel für Dienste verwenden, die mit der Ressource verknüpft sind.accounts.products.regionalInventories Sie können Regionen als Sammlungen von Postleitzahlen oder in einigen Ländern mithilfe vordefinierter geografischer Ziele definieren. Weitere Informationen finden Sie unter Regionen einrichten.

Verwenden Sie die folgenden Methoden, um Regionen zu erstellen und zu aktualisieren:

• Get
• List
• Create
• Patch
• Delete

Region abrufen

Verwenden Sie die accounts.regions.get Methode, um eine in Ihrem Merchant Center-Konto definierte Region abzurufen.

Ein Beispiel für eine Anfrage:

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

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

HTTP/1.1 200

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

Alle Regionen auflisten

Verwenden Sie die accounts.regions.list Methode, um die Regionen in Ihrem Merchant Center-Konto aufzulisten.

Ein Beispiel für eine Anfrage:

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

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

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
    },
  ]
}

Region einfügen

Verwenden Sie die accounts.regions.create Methode, um eine Regionsdefinition in Ihr Merchant Center-Konto einzufügen. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Ein Beispiel für eine Anfrage:

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

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

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

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

So erstellen Sie eine neue Region mit AreaCode:

Ein Beispiel für eine Anfrage:

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

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

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

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

So aktualisieren Sie displayName und GeoTargetCriteriaIds für die erstellte Region:

Ein Beispiel für eine Anfrage:

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

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

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

HTTP/1.1 200

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

Region aktualisieren

Verwenden Sie die accounts.regions.patch Methode, um eine Regionsdefinition in Ihrem Merchant Center-Konto zu aktualisieren. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Ein Beispiel für eine Anfrage:

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"
  }
}

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

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

Region löschen

Verwenden Sie die accounts.regions.delete Methode, um eine Regionsdefinition aus Ihrem Merchant Center-Konto zu löschen. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Ein Beispiel für eine Anfrage:

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

Ein Beispiel für eine Antwort bei einem erfolgreichen Aufruf:

HTTP/1.1 200
{}

Batchvorgänge

Wenn Sie mehrere Regionen verwalten, bietet die Merchant API Batch-Endpunkte, mit denen Sie bis zu 100 Regionen in einem einzigen Aufruf erstellen, aktualisieren und löschen können. Weitere Informationen finden Sie unter Batchvorgänge für Regionen verwalten.