Partager via

Gestion de vos magasins

  • Article

Remarque

La ressource Store est disponible uniquement pour les participants bêta fermés. Pour plus d’informations sur la participation au programme bêta fermé ou open-beta, contactez votre responsable de compte.

Tous les éléments de programmation du Store et la documentation sont susceptibles d’être modifiés pendant la version bêta.

Pour créer un magasin, utilisez le modèle de magasins POST. Le corps de post est un objet StoreCreate . Vous devez spécifier les storeNamechamps , storeDestinationUrlet notificationEmail . Les autres champs sont facultatifs. Vous devez avoir précédemment vérifié et revendiqué l’URL de votre site web.

L’exemple suivant montre un exemple de requête qui spécifie uniquement les champs obligatoires.

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

Si la demande réussit, le corps de la réponse contient un objet Store . L’objet contient les champs que vous avez spécifiés dans la requête, ainsi que tous les champs facultatifs qui fournissent des valeurs par défaut. Le merchantId champ contient l’ID du nouveau magasin et le storeStatus champ indique si le magasin est approuvé.

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

Si l’état est Désapprouvé, l’objet StoreStatus inclut le message champ , qui indique pourquoi le magasin n’a pas été approuvé. Dans l’exemple suivant, le magasin a été désapprouve, car isSslCheckout a la valeur false.

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

Si la validation de la requête POST échoue, le corps de la réponse est un objet ErrorResponse . Pour obtenir la liste des codes d’erreur possibles, consultez Codes d’erreur.

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

Obtention d’une liste de magasins

Pour obtenir la liste des magasins auxquels l’utilisateur a accès, utilisez le modèle de magasins GET. Si vous êtes une agence, incluez les CustomerIden-têtes et CustomerAccountId .

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

La réponse est un objet StoreCollection . Le stores champ contient un tableau d’objets Store .

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

Obtention d’un magasin spécifique

Pour obtenir un magasin spécifique auquel l’utilisateur a accès, utilisez le modèle de magasin GET. Si vous êtes une agence, incluez les CustomerIden-têtes et CustomerAccountId .

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

La réponse est un objet Store .

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