เพิ่มข้อมูลระดับภูมิภาคลงในผลิตภัณฑ์ออนไลน์

คุณสามารถใช้ Merchant Inventories API เพื่อระบุว่าข้อมูลผลิตภัณฑ์แตกต่างกันไปตามภูมิภาค ตัวอย่างเช่น คุณอาจขายผลิตภัณฑ์ที่แตกต่างกันในสถานที่ต่างๆ หรือเรียกเก็บเงินในราคาที่แตกต่างกันสำหรับผลิตภัณฑ์เดียวกันโดยขึ้นอยู่กับสถานที่ซื้อ

ดูข้อมูลเพิ่มเติมได้ที่ความพร้อมจำหน่ายสินค้าและการกำหนดราคาระดับภูมิภาค

ข้อมูลระดับภูมิภาคมีไว้สำหรับผลิตภัณฑ์ที่คุณขายทางออนไลน์ ดูรายละเอียดเกี่ยวกับผลิตภัณฑ์ในร้านได้ที่เพิ่มข้อมูลในร้านลงในผลิตภัณฑ์ในร้าน

ขั้นตอนในการเพิ่มข้อมูลระดับภูมิภาคลงในผลิตภัณฑ์ออนไลน์มีดังนี้

สร้างภูมิภาค

คุณต้องตั้งค่าภูมิภาคสำหรับบัญชีผู้ขายก่อนจึงจะเพิ่มข้อมูลระดับภูมิภาคลงในผลิตภัณฑ์ได้ คุณสามารถใช้แหล่งข้อมูล Merchant API regions เพื่อสร้างภูมิภาคใหม่

ดูตัวอย่างโค้ดและข้อมูลเพิ่มเติมเกี่ยวกับการจัดการภูมิภาคได้ในคู่มือภูมิภาค

ยืนยันว่าคุณมีผลิตภัณฑ์ออนไลน์

คุณสามารถใช้ Merchant API เพื่อกรองผลิตภัณฑ์ในบัญชีตาม channel เพื่อยืนยันว่าคุณมีผลิตภัณฑ์ออนไลน์อยู่แล้ว ผลิตภัณฑ์ออนไลน์ต้องมี online เป็นค่าสำหรับ channel

หากต้องการเพิ่มผลิตภัณฑ์ออนไลน์ลงในบัญชี ให้ใช้ Merchant API เพื่อแทรกผลิตภัณฑ์ใหม่ หรือสร้างแหล่งข้อมูล

แทรกข้อมูลระดับภูมิภาค

หลังจากมีผลิตภัณฑ์ออนไลน์ในบัญชีผู้ขายแล้ว คุณจะเพิ่มข้อมูลระดับภูมิภาค เช่น region, price และ availability ได้

ต่อไปนี้คือตัวอย่างที่คุณสามารถใช้เพื่อเพิ่มข้อมูลระดับภูมิภาคลงในผลิตภัณฑ์ที่มี regionalInventories.insert

Java

  public static void insertRegionalInventory(Config config, String productId, String regionId)
      throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    RegionalInventoryServiceSettings regionalInventoryServiceSettings =
        RegionalInventoryServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    String parent = getParent(config.getMerchantId().toString(), productId);

    try (RegionalInventoryServiceClient regionalInventoryServiceClient =
        RegionalInventoryServiceClient.create(regionalInventoryServiceSettings)) {

      Price price = Price.newBuilder().setAmountMicros(33_450_000).setCurrencyCode("USD").build();

      InsertRegionalInventoryRequest request =
          InsertRegionalInventoryRequest.newBuilder()
              .setParent(parent)
              .setRegionalInventory(
                  RegionalInventory.newBuilder()
                      .setAvailability("out of stock")
                      .setRegion(regionId)
                      .setPrice(price)
                      .build())
              .build();

      System.out.println("Sending insert RegionalInventory request");
      RegionalInventory response = regionalInventoryServiceClient.insertRegionalInventory(request);
      System.out.println("Inserted RegionalInventory Name below");
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }
InsertRegionalInventorySample.java

cURL

  curl --location
  'https://merchantapi.googleapis.com/inventories/v1beta/accounts/987654321/products/en~US~12345/regionalInventories:insert' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <API_TOKEN>' \
  --data '{
     "region": "123456",
     "price": {
         "amountMicros": "33450000",
         "currencyCode": "USD"
     },
     "availability": "out of stock"
  }'

PHP

class InsertRegionalInventory
{
    // ENSURE you fill in the merchant account and product ID for the sample to
    // work.
    private const PARENT = 'accounts/[INSERT_ACCOUNT_HERE]/products/[INSERT_PRODUCT_HERE]';
    // ENSURE you fill in region ID for the sample to work.
    private const REGIONAL_INVENTORY_REGION = 'INSERT_REGION_HERE';

    /**
     * Inserts a regional inventory underneath the parent product.
     *
     * @param string $parent The account and product where this inventory will be inserted.
     *     Format: `accounts/{account}/products/{product}`
     * @param string $regionalInventoryRegion
     *     ID of the region for this
     *     `RegionalInventory` resource. See the [Regional availability and
     *     pricing](https://support.google.com/merchants/answer/9698880) for more details.
     */
    public function insertRegionalInventorySample(string $parent, string $regionalInventoryRegion): void
    {
        // Gets the OAuth credentials to make the request.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates options config containing credentials for the client to use.
        $options = ['credentials' => $credentials];

        // Creates a client.
        $regionalInventoryServiceClient = new RegionalInventoryServiceClient($options);

        // Creates a price object.
        $price = new Price(
            [
                'currency_code' => "USD",
                'amount_micros' => 33450000,
            ]
        );

        // Creates a new regional inventory object.
        $regionalInventory = (new RegionalInventory())
            ->setRegion($regionalInventoryRegion)
            ->setAvailability("in stock")
            ->setPrice($price);

        // Calls the API and catches and prints any network failures/errors.
        try {
            /** @var RegionalInventory $response */
            $response = $regionalInventoryServiceClient->insertRegionalInventory(
                $parent,
                $regionalInventory
            );
            printf('Response data: %s%s', $response->serializeToJsonString(), PHP_EOL);
        } catch (ApiException $ex) {
            printf('Call failed with message: %s%s', $ex->getMessage(), PHP_EOL);
        }
    }

    /**
     * Helper to execute the sample.
     */
    public function callSample(): void
    {
        // Makes the call to insert the regional inventory to the parent product
        // for the given region.
        $this->insertRegionalInventorySample($this::PARENT, $this::REGIONAL_INVENTORY_REGION);
    }

}
InsertRegionalInventory.php

Python

from examples.authentication import generate_user_credentials
from google.shopping import merchant_inventories_v1beta

# ENSURE you fill in the merchant account and product ID for the sample to
# work.
_ACCOUNT = "INSERT_ACCOUNT_HERE"
_PRODUCT = "INSERT_PRODUCT_HERE"
_PARENT = f"accounts/{_ACCOUNT}/products/{_PRODUCT}"
# ENSURE you fill in region ID for the sample to work.
_REGION = "INSERT_REGION_HERE"


def insert_regional_inventory():
  """Inserts a `RegionalInventory` to a given product.

  Replaces the full `RegionalInventory` resource if an entry with the same
  `region` already exists for the product.

  It might take up to 30 minutes for the new or updated `RegionalInventory`
  resource to appear in products.
  """

  # Gets OAuth Credentials.
  credentials = generate_user_credentials.main()

  # Creates a client.
  client = merchant_inventories_v1beta.RegionalInventoryServiceClient(
      credentials=credentials)

  # Creates a regional inventory and populate its attributes.
  regional_inventory = merchant_inventories_v1beta.RegionalInventory()
  regional_inventory.region = _REGION
  regional_inventory.availability = "in stock"
  regional_inventory.price = {
      "currency_code": "USD",
      "amount_micros": 33450000,
  }

  # Creates the request.
  request = merchant_inventories_v1beta.InsertRegionalInventoryRequest(
      parent=_PARENT,
      regional_inventory=regional_inventory,
  )

  # Makes the request and catch and print any error messages.
  try:
    response = client.insert_regional_inventory(request=request)

    print("Insert successful")
    print(response)
  except Exception as e:
    print("Insert failed")
    print(e)
insert_regional_inventory.py

การเรียกใช้นี้จะแสดงผลค่าเดียวกับที่คุณส่ง และอาจไม่ได้แสดงข้อมูลสินค้าคงคลังสุดท้ายอย่างสมบูรณ์

ระบบอาจใช้เวลาถึง 30 นาทีกว่าที่ RegionalInventory ใหม่จะปรากฏในผลิตภัณฑ์

ดูวิธีอื่นๆ ในการเพิ่มข้อมูลสินค้าคงคลังระดับภูมิภาคได้ที่ส่วนแหล่งข้อมูลสินค้าคงคลังของผลิตภัณฑ์ระดับภูมิภาคท้ายส่วนสร้างแหล่งข้อมูลผลิตภัณฑ์

ลงชื่อสมัครใช้ข้อมูลที่แสดงฟรีบน Google

หากต้องการแสดงผลิตภัณฑ์บน Google โดยไม่เสียค่าใช้จ่าย ให้ตั้งค่าข้อมูลผลิตภัณฑ์ที่แสดงฟรี หลังจากตั้งค่าข้อมูลที่แสดงฟรีแล้ว ผลิตภัณฑ์ที่มีสิทธิ์พร้อม RegionalInventory จะแสดงในแท็บ Shopping ของ Google ตามข้อมูลระดับภูมิภาคที่คุณให้ไว้