Verwalten Ihrer Filialen

Hinweis

Die Store-Ressource ist nur für Teilnehmer mit geschlossener Beta verfügbar. Für Informationen zur Teilnahme am Closed-Beta- oder Open-Beta-Programm wenden Sie sich bitte an Ihren Account Manager.

Alle Store-Programmierelemente und -dokumentationen können während der Betaversion geändert werden.

Verwenden Sie zum Erstellen eines Speichers die Vorlage POST-Speicher. Der Textkörper des POST-Objekts ist ein StoreCreate-Objekt . Sie müssen die storeNameFelder , storeDestinationUrlund notificationEmail angeben. Die anderen Felder sind optional. Sie müssen die URL Ihrer Website zuvor überprüft und in Anspruch genommen haben.

Im Folgenden sehen Sie eine Beispielanforderung, die nur die erforderlichen Felder angibt.

curl -X POST -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>" -H "Content-Type: application/json" --data "{\"storeName\": \"Contoso Sports\",\"storeUrl\": \"https://contoso.com\",\"notificationEmail\": [\"someone@example.com\"]}"  https://content.api.ads.microsoft.com/v9.1/bmc/stores

Wenn die Anforderung erfolgreich ist, enthält der Text der Antwort ein Store-Objekt . Das -Objekt enthält die Felder, die Sie in der Anforderung angegeben haben, sowie alle optionalen Felder, die Standardwerte bereitstellen. Das merchantId Feld enthält die ID des neuen Geschäfts, und das storeStatus Feld gibt an, ob der Speicher genehmigt wurde.

{
  "merchantId": 123456,
  "storeName": "Contoso Sports",
  "storeUrl": "https://contoso.com/",
  "notificationEmail": [
    "someone@example.com"
  ],
  "notificationLanguage": "en-US",
  "isSslCheckout": true,
  "isBlockAggregator": false,
  "storeStatus": {
    "status": "Approved"
  }
}

Wenn der Status Abgelehnt lautet, enthält das StoreStatus-Objekt das message Feld, das angibt, warum der Speicher nicht genehmigt wurde. Im folgenden Beispiel wurde der Store abgelehnt, da isSslCheckoutfalse ist.

  "storeStatus": {
    "status": "Disapproved",
    "message": "UnSecuredCheckOut"
  }

Wenn die ÜBERPRÜFUNG der POST-Anforderung fehlschlägt, ist der Text der Antwort ein ErrorResponse-Objekt . Eine Liste der möglichen Fehlercodes finden Sie unter Fehlercodes.

{
  "errors": [
    {
      "code": "DuplicateStoreNameErr",
      "message": "Another store with the specified store name exists; store names must be unique with Microsoft Merchant Center."
    },
    {
      "code": "NotificationLanguageNotSupportedErr",
      "message": "The market that you specified in the notificationLanguage field is not valid."
    }
  ]
}

Abrufen einer Liste von Geschäften

Verwenden Sie die Vorlage GET stores, um eine Liste der Speicher abzurufen, auf die der Benutzer Zugriff hat. Wenn Sie eine Agentur sind, schließen Sie die CustomerIdHeader und CustomerAccountId ein.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores

Die Antwort ist ein StoreCollection-Objekt . Das stores Feld enthält ein Array von Store-Objekten .

{
  "stores": [
    {
      "merchantId": 12345,
      "storeName": "Alpine Ski House",
      "storeUrl": "https://alpineskihouse.com/",
      "notificationEmail": [
        "someone@alpineskihouse.com"],
      "notificationLanguage": "de-De",
      "isSslCheckout": true,
      "isBlockAggregator": false,
      "storeStatus": {
        "status": "Approved"
      }
    },

    . . .

    {
      "merchantId": 67890,
      "storeName": "Fabrikam",
      "storeUrl": "https://fabrikam.com/",
      "notificationEmail": [
        "someone@fabrikam.com"],
      "notificationLanguage": "en-us",
      "isSslCheckout": true,
      "isBlockAggregator": false,
      "storeStatus": {
        "status": "Approved"
      }
    }
  ]
}

Abrufen eines bestimmten Speichers

Verwenden Sie die GET-Speichervorlage, um einen bestimmten Speicher abzurufen, auf den der Benutzer Zugriff hat. Wenn Sie eine Agentur sind, schließen Sie die CustomerIdHeader und CustomerAccountId ein.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345

Die Antwort ist ein Store-Objekt .

{
  "merchantId": 12345,
  "storeName": "Alpine Ski House",
  "storeUrl": "http://www.alpineskihouse.com",
  "notificationEmail": [
    "someone@alpineskihouse.com"],
  "notificationLanguage": "de-DE",
  "isSslCheckout": true,
  "isBlockAggregator": false,
  "storeStatus": {
    "status": "Approved"
  }
}