Administración de las tiendas

Nota:

El recurso De la Tienda solo está disponible para los participantes de la versión beta cerrada. Para obtener información sobre cómo participar en el programa closed-beta o open-beta, póngase en contacto con el administrador de cuentas.

Todos los elementos de programación y la documentación de la Tienda están sujetos a cambios durante la versión beta.

Para crear un almacén, use la plantilla Tiendas POST. El cuerpo del post es un objeto StoreCreate . Debe especificar los storeNamecampos , storeDestinationUrly notificationEmail . Los demás campos son opcionales. Debe haber comprobado y reclamado previamente la dirección URL de su sitio web.

A continuación se muestra una solicitud de ejemplo que especifica solo los campos necesarios.

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 solicitud se realiza correctamente, el cuerpo de la respuesta contiene un objeto Store . El objeto contiene los campos especificados en la solicitud más todos los campos opcionales que proporcionan valores predeterminados. El merchantId campo contiene el identificador del nuevo almacén y el storeStatus campo indica si el almacén está aprobado.

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

Si el estado es Desaprobado, el objeto StoreStatus incluye el message campo , lo que indica por qué no se aprobó el almacén. En el ejemplo siguiente, el almacén se ha desaprobado porque isSslCheckout es false.

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

Si se produce un error en la validación de la solicitud POST, el cuerpo de la respuesta es un objeto ErrorResponse . Para obtener una lista de posibles códigos de error, consulte Códigos de error.

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

Obtención de una lista de tiendas

Para obtener una lista de los almacenes a los que el usuario tiene acceso, use la plantilla GET stores . Si es una agencia, incluya los CustomerIdencabezados y 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 respuesta es un objeto StoreCollection . El stores campo contiene una matriz de objetos 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"
      }
    }
  ]
}

Obtención de un almacén específico

Para obtener un almacén específico al que el usuario tiene acceso, use la plantilla de almacén GET. Si es una agencia, incluya los CustomerIdencabezados y 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 respuesta es un objeto 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"
  }
}