Możesz użyć interfejsu Merchant Inventories API, aby wskazać, że Twój produkt informacje różnią się w zależności od regionu. Możesz na przykład sprzedawać różne produkty w w różnych miejscach lub naliczaj różne ceny za te same produkty w zależności od tego, miejsca zakupu.
Sprawdź regionalną dostępność oraz cennik.
Informacje regionalne dotyczą produktów, które sprzedajesz online. Zobacz Dodawanie informacji o stanie sklepu informacji lokalnych produkty, aby dowiedzieć się więcej. w Twoich sklepach stacjonarnych.
Aby dodać informacje regionalne do produktów online:
Utwórz regiony
Zanim dodasz do produktu informacje regionalne, musisz skonfigurować regiony
na koncie sprzedawcy. Za pomocą interfejsu Content API for Shopping możesz
regions zasób do utworzenia
w nowych regionach.
Kod znajdziesz w przewodniku po regionach. próbkę i więcej informacji na temat zarządzania regionami.
Potwierdź, że masz produkty online
Za pomocą interfejsu Content API for Shopping możesz filtrować produkty na
do channel, aby potwierdzić, że
masz już produkty online. Produkty online muszą mieć atrybut online jako
dla klienta channel.
Jeśli chcesz dodać do konta produkty online, użyj Content API do Zakupy, aby wstawić nowe usług lub utworzyć plik danych.
Wstaw informacje regionalne
Gdy masz już produkty online na koncie sprzedawcy, możesz dodać produkty regionalne
informacje, takie jak region, price i availability.
Oto przykład, którego możesz użyć, aby dodać informacje regionalne do produktu z
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);
}
}
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);
}
}
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)
Wywołanie zwraca dokładnie te same wartości, które zostały przez Ciebie przesłane, i może nie reprezentuje ostateczne dane o asortymencie.
Może minąć do 30 minut, zanim nowy RegionalInventory pojawi się w
usługi.
Przeczytaj sekcję Pliki danych o regionalnym asortymencie produktów na końcu instrukcji tworzenia pliku danych kanału, gdzie znajdziesz więcej sposobów dodawania informacje o asortymencie regionalnym.
Rejestrowanie się w bezpłatnych informacjach w Google
Aby bezpłatnie wyświetlać produkty w Google, skonfiguruj bezpłatny produkt
. Po skonfigurowaniu bezpłatnej konfiguracji
informacje o produktach, odpowiednie produkty z atrybutem RegionalInventory mogą wyświetlać się w
Na karcie Zakupy, na podstawie podanych przez Ciebie informacji regionalnych.