ایجاد و به‌روزرسانی مناطق

در Merchant API می‌توانید از مناطق جغرافیایی به‌عنوان هدف برای سرویس‌های مرتبط با منبع accounts.products.regionalInventories استفاده کنید. می‌توانید مناطق را به‌عنوان مجموعه‌ای از کدهای پستی یا، در برخی کشورها، بااستفاده از هدف‌یابی‌های جغرافیایی ازپیش تعریف‌شده تعریف کنید. برای اطلاعات بیشتر، راه‌اندازی مناطق را ببینید.

برای ایجاد و به‌روزرسانی مناطق، می‌توانید از روش‌های زیر استفاده کنید:

بازیابی منطقه

برای بازیابی منطقه‌ای که در حساب Merchant Center شما تعریف شده است، از روش accounts.regions.get استفاده کنید.

در اینجا یک درخواست نمونه آورده شده است:

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

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

HTTP/1.1 200

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

فهرست کردن همه مناطق

برای فهرست کردن مناطق در حساب Merchant Center، از روش accounts.regions.list استفاده کنید.

در اینجا یک درخواست نمونه آورده شده است:

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

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

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

درج منطقه

برای درج تعریف منطقه در حساب Merchant Center، از روش accounts.regions.create استفاده کنید. اجرای این روش به دسترسی سرپرست نیاز دارد.

در اینجا یک درخواست نمونه آورده شده است:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=987654
{
  "displayName": "TestRegion",
  "name": "987654",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98109"
      }
    ],
    "regionCode": "US"
  }
}

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

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

برای ایجاد منطقه جدید با AreaCode:

در اینجا یک درخواست نمونه آورده شده است:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=168888 HTTP/1.1
{
  "displayName": "WA_test",
  "name": "168888",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20101
    ]
  }
}

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

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

برای به‌روزرسانی displayName و GeoTargetCriteriaIds برای منطقه ایجادشده:

در اینجا یک درخواست نمونه آورده شده است:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea HTTP/1.1
{
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20100
    ]
  }
}

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

HTTP/1.1 200

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

به‌روزرسانی منطقه

برای به‌روزرسانی تعریف منطقه در حساب Merchant Center، از روش accounts.regions.patch استفاده کنید. اجرای این روش به دسترسی سرپرست نیاز دارد.

در اینجا یک درخواست نمونه آورده شده است:

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

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

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

حذف منطقه

برای حذف تعریف منطقه از حساب Merchant Center، از روش accounts.regions.delete استفاده کنید. اجرای این روش به دسترسی سرپرست نیاز دارد.

در اینجا یک درخواست نمونه آورده شده است:

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

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

HTTP/1.1 200
{}

عملیات گروهی

اگر چندین منطقه را مدیریت می‌کنید، Merchant API نقاط پایانی دسته‌ای ارائه می‌دهد که به شما امکان می‌دهد تا ۱۰۰ منطقه را در یک فراخوانی ایجاد، به‌روزرسانی، و حذف کنید. برای اطلاعات بیشتر، به مدیریت گروه‌بندی منطقه‌ای مراجعه کنید.