Referencia de Listings Restrictions API v2021-08-01
Acceso programático a las restricciones en los Listings Restrictions API v2021-08-01
Descripción general
La Selling Partner API para restricciones de listados(Listings Restrictions API) brinda acceso programático a las restricciones en los listados del catálogo de Amazon.
Para obtener más información, consulte la Guía de casos de uso de la Listings Restrictions API .
Información de versión
Versión : 2021-08-01
Información del contacto
Contacto : Soporte para desarrolladores Selling Partner API
URL de contacto : https://sellercentral.amazon.com/gp/mws/contactus.html
Información de licencia
Licencia : Licencia Apache 2.0
URL de la licencia : http://www.apache.org/licenses/LICENSE-2.0
esquema URI
Anfitrión : Sellingpartnerapi-na.amazon.com
Esquemas : HTTPS
consume
application/json
produce
application/json
Operaciones
Rutas
GET /listings/2021-08-01/restrictions
Operación: getListingsRestrictions
Descripción
Devuelve las restricciones de publicación de un artículo en el catálogo de Amazon.
Plan de uso:
| Tasa (solicitudes por segundo) | Explosión |
|---|---|
| 5 | 10 |
El header de respuesta x-amzn-RateLimit-Limit devuelve los límites de tarifa del plan de uso que se aplicaron a la operación solicitada, cuando estén disponibles. La tabla anterior indica la tasa predeterminada y los valores de ráfaga para esta operación. Los Selling partners cuyas demandas comerciales requieren un mayor rendimiento pueden ver valores de tasa y ráfaga más altos que los que se muestran aquí. Para obtener más información, consulte Planes de uso y límites de tarifas en la API de Selling partners .
Parámetros
| Tipo | Nombre | Descripción | Esquema |
|---|---|---|---|
| Query | asin requerido | Número de identificación estándar de Amazon (ASIN) del Item publicado. | string |
| Query | conditionType opcional | Identifica la condición del Item listado. | enum ( ConditionType ) |
| Query | sellerId requerido | Un identificador de selling partner, como una cuenta de comerciante. | string |
| Query | marketplaceIds requerido | Una lista delimitada por comas de identificadores de marketplace de Amazon para la solicitud. | array (csv) |
| Query | reasonLocale opcional | Una configuración regional para la localización del texto del motivo. Cuando no se proporciona, se utiliza el código de idioma predeterminado del primer marketplace. Ejemplos: "en_US", "fr_CA", "fr_FR". Los mensajes localizados tienen el valor predeterminado "en_US" cuando una localización no está disponible en la configuración regional especificada. | string |
Respuestas
| Código HTTP | Descripción | Esquema |
|---|---|---|
| 200 | Comprendió con éxito la solicitud de patch del listings items. Consulte la respuesta para determinar si se aceptó el envío. headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. x-amzn-RequestId (string): identificador de referencia de solicitud único. | RestrictionList |
Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .
consume
application/json
produce
application/json
Respuestas de error y esquemas
Esta tabla contiene códigos de estado HTTP e información asociada para respuestas de error.
| Código HTTP | Descripción | Esquema |
|---|---|---|
| 400 | La solicitud tiene parámetros faltantes o no válidos y no se puede analizar. headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 403 | Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida. headers : x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 404 | El recurso especificado no existe. headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 413 | El tamaño de la solicitud excedió el tamaño máximo aceptado. headers : x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 415 | La carga útil de la solicitud está en un formato no admitido. headers : x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 429 | La frecuencia de las solicitudes fue mayor a la permitida. headers : x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 500 | Ocurrió una condición inesperada que impidió que el servidor cumpliera con la solicitud. headers : x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
| 503 | Sobrecarga temporal o mantenimiento del servidor. headers : x-amzn-RequestId (string): identificador de referencia de solicitud único. | Lista de errores |
Definiciones
RestrictionList
Una lista de restricciones para el artículo del catálogo de Amazon especificado.
| Nombre | Esquema |
|---|---|
| restrictions requerido | < Restriction > array |
Restriction
Una restricción de listado, calificada opcionalmente por una condición, con una lista de razones para la restricción.
| Nombre | Descripción | Esquema |
|---|---|---|
| marketplaceId requerido | Un identificador de marketplace. Identifica el marketplace de Amazon donde se aplica la restricción. | string |
| conditionType opcional | La condición que se aplica a la restricción. | enum ( conditionType ) |
| reasons opcional | Una lista de razones para la restricción. | < Reason > array |
Reason
Un motivo de la restricción, incluidos los links directos de ruta que pueden permitir a los Selling Partners eliminar la restricción, si está disponible.
| Nombre | Descripción | Esquema |
|---|---|---|
| message requerido | Un mensaje que describe el motivo de la restricción. | string |
| reasonCode opcional | Un código que indica por qué la lista está restringida. | enum ( ReasonCode ) |
| links opcional | Una lista de links directos de ruta que pueden permitir a los Selling Partners eliminar la restricción. | array |
Link
Un link a los recursos relacionados con una restricción de publicación.
| Nombre | Descripción | Esquema |
|---|---|---|
| resource requerido | El URI del recurso relacionado. | string (uri) |
| verb requerido | El verbo HTTP utilizado para interactuar con el recurso relacionado. | enum ( Verb ) |
| title opcional | El título del recurso relacionado. | string |
| type opcional | El tipo de medio del recurso relacionado. | string |
Lista de errores
Una lista de respuestas de error devueltas cuando una solicitud no se realiza correctamente.
Error
Respuesta de error devuelta cuando la solicitud no tiene éxito.
| Nombre | Descripción | Esquema |
|---|---|---|
| código requerido | Un código de error que identifica el tipo de error que ocurrió. | string |
| mensaje requerido | Un mensaje que describe la condición de error. | string |
| detalles opcional | Detalles adicionales que pueden ayudar a la persona que llama a comprender o solucionar el problema. | string |
Verb
El verbo HTTP utilizado para interactuar con el recurso relacionado.
Tipo : enum
| Valor | Descripción |
|---|---|
| GET | Se accede al recurso proporcionado con el método HTTP GET. |
ReasonCode
Un código que indica por qué la lista está restringida.
Tipo : enum
| Valor | Descripción |
|---|---|
| APPROVAL_REQUIRED | Se requiere aprobación para crear una lista para el ASIN especificado. Se proporcionará un link de ruta hacia adelante que puede permitir que los Selling Partners eliminen la restricción. |
| ASIN_NOT_FOUND | El ASIN especificado no existe en el marketplace solicitado. |
| NOT_ELIGIBLE | No elegible para crear una lista para el ASIN especificado. No se proporcionará ningún link directo de ruta para eliminar la restricción. |
ConditionType
Tipo : enum
Para usar con la(s) definición(es): Restriction
La condición que se aplica a la restricción.
| Valor | Descripción |
|---|---|
| new_new | Nuevo |
| new_open_box | Nuevo - Caja Abierta. |
| new_oem | Nuevo - OEM. |
| refurbished_refurbished | Renovar |
| used_like_new | Usado - Como Nuevo. |
| used_very_good | Usado - Muy Bueno. |
| used_good | Usado - Bueno. |
| used_acceptable | Usado - Aceptable. |
| collectible_like_new | Coleccionable - Como nuevo. |
| collectible_very_good | Coleccionable - Muy bueno. |
| collectible_good | Coleccionable - Bueno. |
| collectible_acceptable | Coleccionable - Aceptable. |
| club_club | Club |
Para usar con la(s) operación(es): getListingsRestrictions
La condición utilizada para filtrar las restricciones.
| Valor | Descripción |
|---|---|
| new_new | Nuevo |
| new_open_box | Nuevo - Caja Abierta. |
| new_oem | Nuevo - OEM. |
| refurbished_refurbished | Renovar |
| used_like_new | Usado - Como Nuevo. |
| used_very_good | Usado - Muy Bueno. |
| used_good | Usado - Bueno. |
| used_acceptable | Usado - Aceptable. |
| collectible_like_new | Coleccionable - Como nuevo. |
| collectible_very_good | Coleccionable - Muy bueno. |
| collectible_good | Coleccionable - Bueno. |
| collectible_acceptable | Coleccionable - Aceptable. |
| club_club | Club |
Updated over 1 year ago