Verwalten Ihrer Kataloge
Die Inhalts-API ist eine RESTful-API, die die Catalogs-Ressource verwendet, um Kataloge in Ihrem Microsoft Merchant Center-Speicher (MMC) zu verwalten.
Im Folgenden sehen Sie den Basis-URI, den Sie zum Aufrufen der Inhalts-API verwenden.
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/
Jede HTTP-Anforderung muss das OAuth-Zugriffstoken des Benutzers und Ihr Entwicklertoken enthalten. Um das Zugriffstoken des Benutzers anzugeben, legen Sie den AuthenticationToken-Header fest. Um Ihr Entwicklertoken anzugeben, legen Sie den DeveloperToken-Header fest.
Wenn Sie Kataloge im Namen anderer Kunden verwalten, müssen Sie Folgendes festlegen:
- Der CustomerId-Header zur Kunden-ID des Kunden, dessen Geschäft Sie verwalten.
- Der CustomerAccountId-Header auf die Konto-ID eines der Konten des Kunden, die Sie verwalten (es spielt keine Rolle, welches verwaltete Konto verwendet wird).
Standardmäßig verwendet die Inhalts-API JSON-Objekte, um die Kataloge darzustellen. Um XML zu verwenden, legen Sie den Abfrageparameter alt auf XML fest.
Ausführliche Informationen zur Verwendung der Catalogs-Ressource finden Sie in den folgenden Abschnitten.
- Abrufen eines Katalogs aus dem Store
- Abrufen der Liste der Kataloge aus dem Store
- Löschen eines Katalogs aus dem Speicher
- Hinzufügen eines Katalogs zum Speicher
- Aktualisieren eines Katalogs im Store
Ein Codebeispiel zum Abrufen, Hinzufügen, Aktualisieren und Löschen von Katalogen finden Sie unter Codebeispiel für Verwalten von Katalogen.
Abrufen eines Katalogs aus dem Store
Um einen Katalog aus dem Speicher abzurufen, fügen Sie die folgende Vorlage an den Basis-URI an.
{bmcMerchantId}/catalogs/{catalogId}
Legen Sie {bmcMerchantId} auf Ihre MMC-Speicher-ID und auf die ID des Katalogs fest{catalogId}.
Senden Sie eine HTTP GET-Anforderung an die resultierende URL. Wenn der Katalog gefunden wurde, enthält die Antwort ein Catalog-Objekt , das die Details des Katalogs enthält.
Abrufen einer Liste von Katalogen aus dem Store
Um eine Liste von Katalogen aus dem Speicher abzurufen, fügen Sie die folgende Vorlage an den Basis-URI an.
{bmcMerchantId}/catalogs
Legen Sie auf Ihre MMC-Speicher-ID fest {bmcMerchantId} .
Senden Sie eine HTTP GET-Anforderung an die resultierende URL. Wenn der Speicher Kataloge enthält, enthält die Antwort ein Catalogs-Objekt , das die Liste der Kataloge enthält.
Löschen eines Katalogs aus dem Speicher
Um einen Katalog aus dem Speicher zu löschen, fügen Sie die folgende Vorlage an den Basis-URI an.
{bmcMerchantId}/catalogs/{catalogId}
Legen Sie {bmcMerchantId} auf Ihre MMC-Speicher-ID und auf die ID des Katalogs fest{catalogId}.
Senden Sie eine HTTP DELETE-Anforderung an die resultierende URL. Wenn der Katalog gefunden wurde, wird er gelöscht.
Hinzufügen eines Katalogs zum Speicher
Sie verwenden Kataloge, um Ihre Produkte logisch zu gruppieren. Um dem Speicher einen Katalog hinzuzufügen, fügen Sie die folgende Vorlage an den Basis-URI an.
{bmcMerchantId}/catalogs
Legen Sie auf Ihre MMC-Speicher-ID fest {bmcMerchantId} .
Senden Sie eine HTTP POST-Anforderung an die resultierende URL. Wenn der Katalog hinzugefügt wird, enthält die Antwort ein Catalog-Objekt . Das Catalog -Objekt enthält die ID des Katalogs. Verwenden Sie die ID, um den Katalog abzurufen und zu löschen.
Der Text der Anforderung ist ein Catalog-Objekt . Sie müssen die folgenden Felder angeben.
Der von Ihnen angegebene Name muss innerhalb des Speichers eindeutig sein und ist auf maximal 70 Zeichen beschränkt. Der Markt gibt an, wo die Produkte serviert werden. Eine Liste der unterstützten Märkte finden Sie unter Markt. Produkte werden nur bereitgestellt, wenn isPublishingEnabledtrue ist. Ausführliche Informationen dazu, wie Sie Ihre App zum Testen verwenden können isPublishingEnabled , finden Sie unter Testen Ihres Codes in der Sandbox.
Aktualisieren eines Katalogs im Store
Um einen Katalog im Speicher zu aktualisieren, fügen Sie die folgende Vorlage an den Basis-URI an.
{bmcMerchantId}/catalogs/{catalogId}
Legen Sie {bmcMerchantId} auf Ihre MMC-Speicher-ID und auf die ID des Katalogs fest{catalogId}.
Der Text der Anforderung ist ein Catalog-Objekt . Sie müssen die folgenden Felder angeben.
Senden Sie eine HTTP PUT-Anforderung an die resultierende URL. Wenn der Katalog aktualisiert wird, enthält die Antwort das aktualisierte Catalog-Objekt .