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

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

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

• Get
• List
• Create
• Patch
• Delete

یک منطقه را بازیابی کنید

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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/125222396/regions/234567?key=[YOUR_API_KEY]

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

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/v1beta/accounts/125222396/regions?pageSize=100&key=[YOUR_API_KEY]

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

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/v1beta/accounts/102959835/regions?regionId=987654&key=[YOUR_API_KEY]

{
  "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/v1beta/accounts/102959835/regions?regionId=168888&key=[YOUR_API_KEY] 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/v1beta/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea&key=[YOUR_API_KEY] 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/v1beta/accounts/102959835/regions/987654?updateMask=displayName%2CpostalCodeArea&key=[YOUR_API_KEY] 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/v1beta/accounts/102959835/regions/987654?key=[YOUR_API_KEY] HTTP/1.1

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

HTTP/1.1 200
{}