Mağazalarınızı yönetme

Not

Mağaza kaynağı yalnızca kapalı beta katılımcıları tarafından kullanılabilir. Kapalı beta veya açık beta programına katılma hakkında bilgi için lütfen hesap yöneticinize başvurun.

Tüm Store programlama öğeleri ve belgeleri beta sırasında değiştirilebilir.

Mağaza oluşturmak için POST stores şablonunu kullanın. POST'un gövdesi bir StoreCreate nesnesidir. , storeDestinationUrlve notificationEmail alanlarını belirtmeniz storeNamegerekir. Diğer alanlar isteğe bağlıdır. Web sitenizin URL'sini daha önce doğrulamış ve talep etmiş olmanız gerekir.

Aşağıda yalnızca gerekli alanları belirten örnek bir istek gösterilmektedir.

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

İstek başarılı olursa, yanıtın gövdesi bir Store nesnesi içerir. nesnesi, istekte belirttiğiniz alanların yanı sıra varsayılan değerleri sağlayan tüm isteğe bağlı alanları içerir. Alanı merchantId yeni mağazanın kimliğini içerir ve storeStatus alan, mağazanın onaylanıp onaylanmamış olduğunu gösterir.

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

Durum Onaylanmadı ise StoreStatus nesnesi, mağazanınmessage neden onaylanmadiğini gösteren alanını içerir. Aşağıdaki örnekte, yanlış olduğundan isSslCheckout mağaza onaylanmamıştır.

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

POST isteğinin doğrulaması başarısız olursa, yanıtın gövdesi bir ErrorResponse nesnesidir. Olası hata kodlarının listesi için bkz. Hata kodları.

{
  "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."
    }
  ]
}

Mağazaların listesini alma

Kullanıcının erişimi olan mağazaların listesini almak için GET stores şablonunu kullanın. Bir ajanssanız ve CustomerAccountIdbaşlıklarını ekleyinCustomerId.

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

Yanıt bir StoreCollection nesnesidir. alanı stores , Store nesnelerinin bir dizisini içerir.

{
  "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"
      }
    }
  ]
}

Belirli bir mağazayı alma

Kullanıcının erişimi olan belirli bir mağazayı almak için GET store şablonunu kullanın. Bir ajanssanız ve CustomerAccountIdbaşlıklarını ekleyinCustomerId.

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

Yanıt bir Store nesnesidir.

{
  "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"
  }
}