Mit der Merchant Inventories API können Sie angeben, im Geschäft erhältlich.
Für lokal erhältliche Produkte sind einige zusätzliche Informationen erforderlich, z. B. storeCode und
availability. Siehe Feed mit lokalem Inventar
Spezifikation.
Felder, die Sie angeben können.
So fügen Sie Ihren lokal erhältlichen Produkten Informationen im Geschäft hinzu:
Unternehmen mit dem Merchant Center verknüpfen
Sie benötigen ein Unternehmensprofil und einen Händler Konto zum Auflisten lokal erhältliche Produkte auf Google.
Richten Sie Ihre Konten für lokale Kampagnen ein. Produkteinträge und Unternehmen hinzufügen Informationen.
Nachdem Sie Ihre Konten eingerichtet haben, verknüpfen Sie Ihr Unternehmensprofil mit Ihrem Merchant Center-Konto Konto.
Sie können auch die Content API for Shopping verwenden. v2.1 um Ihre Konten zu verknüpfen.
Prüfen, ob lokal erhältliche Produkte vorhanden sind
Mit der Content API for Shopping können Sie die Produkte in Ihren
Konto bis zum channel, um zu bestätigen,
lokal erhältliche Produkte. Für lokal erhältliche Produkte muss der Wert local angegeben werden
für das channel.
Wenn Sie Ihrem Konto lokal erhältliche Produkte hinzufügen möchten, verwenden Sie die Content API für Shopping zum Einfügen neuer Produkten oder erstellen Sie einen Feed.
Informationen zum Geschäft einfügen
Sobald Sie lokal erhältliche Produkte in Ihrem Händlerkonto haben, können Sie im Geschäft vorrätige Produkte hinzufügen.
Informationen wie store_code, price und availability.
Hier sehen Sie ein Beispiel, mit dem Sie bei einem Produkt Informationen im Geschäft mit
localInventories.list:
Java
public static void insertLocalInventory(Config config, String productId, String storeCode)
throws Exception {
GoogleCredentials credential = new Authenticator().authenticate();
LocalInventoryServiceSettings localInventoryServiceSettings =
LocalInventoryServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(credential))
.build();
String parent = getParent(config.getMerchantId().toString(), productId);
try (LocalInventoryServiceClient localInventoryServiceClient =
LocalInventoryServiceClient.create(localInventoryServiceSettings)) {
Price price = Price.newBuilder().setAmountMicros(33_450_000).setCurrencyCode("USD").build();
InsertLocalInventoryRequest request =
InsertLocalInventoryRequest.newBuilder()
.setParent(parent)
.setLocalInventory(
LocalInventory.newBuilder()
.setAvailability("out of stock")
.setStoreCode(storeCode)
.setPrice(price)
.build())
.build();
System.out.println("Sending insert LocalInventory request");
LocalInventory response = localInventoryServiceClient.insertLocalInventory(request);
System.out.println("Inserted LocalInventory 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/localInventories:insert' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{
"storeCode": "123456",
"price": {
"amountMicros": "33450000",
"currencyCode": "USD"
},
"availability": "out of stock"
}'
PHP
class InsertLocalInventory
{
// 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 store code for the sample to work.
private const LOCAL_INVENTORY_STORE_CODE = 'INSERT_STORE_CODE_HERE';
/**
* Inserts a local 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 $localInventoryRegion
* ID of the region for this
* `LocalInventory` resource. See the [Local availability and
* pricing](https://support.google.com/merchants/answer/9698880) for more details.
*/
public function insertLocalInventorySample(
string $parent,
string $localInventoryStoreCode
): 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.
$localInventoryServiceClient = new LocalInventoryServiceClient($options);
// Creates a price object.
$price = new Price(
[
'currency_code' => "USD",
'amount_micros' => 33450000,
]
);
// Creates a new local inventory object.
$localInventory = (new LocalInventory())
->setStoreCode($localInventoryStoreCode)
->setAvailability("in stock")
->setPrice($price);
// Calls the API and catches and prints any network failures/errors.
try {
/** @var LocalInventory $response */
$response = $localInventoryServiceClient->insertLocalInventory(
$parent,
$localInventory
);
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 local inventory to the parent product
// for the given region.
$this->insertLocalInventorySample($this::PARENT, $this::LOCAL_INVENTORY_STORE_CODE);
}
}
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 store code for the sample to work.
_STORE_CODE = "INSERT_STORE_CODE_HERE"
def insert_local_inventory():
"""Inserts a `LocalInventory` to a given product.
Replaces the full `LocalInventory` 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 `LocalInventory`
resource to appear in products.
"""
# Gets OAuth Credentials.
credentials = generate_user_credentials.main()
# Creates a client.
client = merchant_inventories_v1beta.LocalInventoryServiceClient(
credentials=credentials)
# Creates a Local inventory and populate its attributes.
local_inventory = merchant_inventories_v1beta.LocalInventory()
local_inventory.store_code = _STORE_CODE
local_inventory.availability = "in stock"
local_inventory.price = {
"currency_code": "USD",
"amount_micros": 33450000,
}
# Creates the request.
request = merchant_inventories_v1beta.InsertLocalInventoryRequest(
parent=_PARENT,
local_inventory=local_inventory,
)
# Makes the request and catch and print any error messages.
try:
response = client.insert_local_inventory(request=request)
print("Insert successful")
print(response)
except Exception as e:
print("Insert failed")
print(e)
Bei diesem Aufruf werden genau die gleichen Werte zurückgegeben wie von Ihnen gesendet. steht für die endgültigen Inventardaten.
Es kann bis zu 30 Minuten dauern, bis die neuen LocalInventory in der
Produkt.
Sie können auch die Merchant Center-Benutzeroberfläche verwenden, um ein lokales Produktinventar zu erstellen. .
Für lokale Produkteinträge registrieren
Nachdem Sie ein Unternehmensprofil mit Ihrem Händlerkonto verknüpft haben, können Sie sich für lokale Produkteinträge. Folgen Sie den kostenlosen Einträgen Richtlinien.
Durch die Teilnahme an lokalen kostenlosen Produkten Ihren Produkteinträgen, Ihren im Geschäft erhältlichen Produkten können in Produkteinträgen in verschiedenen Google-Produkten erscheinen.