Merchant API

Administra tus cuentas de Merchant Center de manera programática.

Servicio: merchantapi.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la información siguiente cuando realices las solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona los siguientes documentos de Discovery:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://merchantapi.googleapis.com

Recurso de REST: reports_v1beta.accounts.reports

Métodos
search POST /reports/v1beta/{parent=accounts/*}/reports:search
Recupera un informe definido por una búsqueda.

Recurso de REST: quota_v1beta.accounts.quotas

Métodos
list GET /quota/v1beta/{parent=accounts/*}/quotas
Muestra una lista de la cuota diaria de llamadas y el uso por grupo de tu cuenta de Merchant Center.

Recurso de REST: promotions_v1beta.accounts.promotions

Métodos
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
Recupera la promoción de su cuenta de Merchant Center.
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
Inserta una promoción en tu cuenta de Merchant Center.
list GET /promotions/v1beta/{parent=accounts/*}/promotions
Muestra una lista de las promociones en tu cuenta de Merchant Center.

Recurso de REST: products_v1beta.accounts.productInputs

Métodos
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
Borra la entrada de un producto de tu cuenta de Merchant Center.
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
Sube la entrada de un producto a tu cuenta de Merchant Center.

Recurso de REST: products_v1beta.accounts.products

Métodos
get GET /products/v1beta/{name=accounts/*/products/*}
Recupera el producto procesado de su cuenta de Merchant Center.
list GET /products/v1beta/{parent=accounts/*}/products
Muestra una lista de los productos procesados en tu cuenta de Merchant Center.

Recurso REST: notifications_v1beta.accounts.notificationsubscriptions

Métodos
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Crea una suscripción a notificaciones para un comercio.
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Borra una suscripción a notificaciones de un comercio.
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Permite obtener las suscripciones a notificaciones de una cuenta.
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Obtiene todas las suscripciones a notificaciones de un comercio.
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
Actualiza una suscripción a notificaciones existente de un comercio.

Recurso de REST: lfp_v1beta.accounts.lfpInventories

Métodos
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
Inserta un recurso LfpInventory para la cuenta de comerciante de destino determinada.

Recurso de REST: lfp_v1beta.accounts.lfpSales

Métodos
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
Inserta un LfpSale para el comercio determinado.

Recurso de REST: lfp_v1beta.accounts.lfpStores

Métodos
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
Borra un almacén de un comercio de destino.
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
Recupera información sobre un almacén.
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
Inserta una tienda para el comercio objetivo.
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
Muestra una lista de las tiendas del comercio objetivo, según la especificación del filtro en ListLfpStoresRequest.

Recurso de REST: inventories_v1beta.accounts.products.localInventories

Métodos
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
Borra el LocalInventory especificado del producto especificado en tu cuenta de comerciante.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
Inserta un recurso LocalInventory en un producto de tu cuenta de comerciante.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
Enumera los recursos LocalInventory para el producto especificado en tu cuenta de comerciante.

Recurso de REST: inventories_v1beta.accounts.products.regionalInventories

Métodos
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
Borra el recurso RegionalInventory especificado del producto especificado en tu cuenta de comerciante.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
Inserta un RegionalInventory en un producto determinado en tu cuenta de comerciante.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
Enumera los recursos RegionalInventory para el producto especificado en tu cuenta de comerciante.

Recurso de REST: datasources_v1beta.accounts.dataSources

Métodos
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
Crea la nueva configuración de fuente de datos para la cuenta determinada.
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
Borra una fuente de datos de tu cuenta de Merchant Center.
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
Realiza la recuperación de datos de inmediato (incluso fuera de la programación de actualización) en una fuente de datos de tu cuenta de Merchant Center.
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
Recupera la configuración de la fuente de datos para la cuenta determinada.
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
Enumera las configuraciones de las fuentes de datos de la cuenta determinada.
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
Actualiza la configuración de la fuente de datos existente.

Recurso de REST: conversions_v1beta.accounts.conversionSources

Métodos
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
Crea una nueva fuente de conversiones.
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
Archiva una fuente de conversiones existente.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
Recupera una fuente de conversiones.
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
Recupera la lista de fuentes de conversiones a las que tiene acceso el emisor.
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
Actualiza la información de una fuente de conversiones existente.
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
Vuelve a habilitar una fuente de conversiones archivada.

Recurso de REST: accounts_v1beta.accounts

Métodos
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
Crea una cuenta independiente de Merchant Center con configuración adicional.
delete DELETE /accounts/v1beta/{name=accounts/*}
Borra la cuenta especificada independientemente de su tipo: independiente, MCA o cuenta secundaria.
get GET /accounts/v1beta/{name=accounts/*}
Recupera una cuenta de su cuenta de Merchant Center.
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
Recupera la identidad empresarial de una cuenta.
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
Recupera la información de la empresa de una cuenta.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
Recupera la página principal de una tienda.
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
Recupera la información de configuración de envío.
list GET /accounts/v1beta/accounts
Enumera las cuentas a las que puede acceder el usuario que realiza la llamada y que coinciden con las restricciones de la solicitud, como el tamaño de la página o los filtros.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
Enumera todas las cuentas secundarias de una cuenta de varios clientes determinada.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
Actualiza una cuenta independientemente de su tipo: independiente, MCA o cuenta secundaria.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
Actualiza la identidad de la empresa de una cuenta.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
Actualiza la información de la empresa de una cuenta.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
Actualiza la página principal de una tienda.

Recurso de REST: accounts_v1beta.accounts.accounttax

Métodos
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
Devuelve las reglas fiscales que coinciden con las condiciones de GetAccountTaxRequest
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
Indica la configuración impositiva de las cuentas secundarias únicamente en tu cuenta de Merchant Center.
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
Actualiza la configuración fiscal de la cuenta.

Recurso de REST: accounts_v1beta.accounts.homepage

Métodos
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
Reclama la página principal de una tienda.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
Anula el reclamo de la página principal de una tienda.

Recurso de REST: accounts_v1beta.accounts.issues

Métodos
list GET /accounts/v1beta/{parent=accounts/*}/issues
Muestra una lista de todos los problemas de una cuenta de Merchant Center.

Recurso de REST: accounts_v1beta.accounts.onlineReturnPolicies

Métodos
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
Obtiene una política de devoluciones existente.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
Enumera todas las políticas de devoluciones existentes.

Recurso de REST: accounts_v1beta.accounts.programs

Métodos
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
Inhabilita la participación de la cuenta en el programa especificado.
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
Habilita la participación en el programa especificado para la cuenta.
get GET /accounts/v1beta/{name=accounts/*/programs/*}
Recupera el programa especificado para la cuenta.
list GET /accounts/v1beta/{parent=accounts/*}/programs
Recupera todos los programas de la cuenta.

Recurso de REST: accounts_v1beta.accounts.regions

Métodos
create POST /accounts/v1beta/{parent=accounts/*}/regions
Crea una definición de región en tu cuenta de Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
Borra una definición de región de tu cuenta de Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/regions/*}
Recupera una región definida en la cuenta de Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/regions
Muestra una lista de las regiones de tu cuenta de Merchant Center.
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
Actualiza una definición de región en tu cuenta de Merchant Center.

Recurso de REST: accounts_v1beta.accounts.shippingSettings

Métodos
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
Reemplaza la configuración de envío de un comercio con la configuración de envío de la solicitud.

Recurso de REST: accounts_v1beta.accounts.termsOfServiceAgreementStates

Métodos
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
Muestra el estado de un acuerdo de Condiciones del Servicio.
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
Recupera el estado del acuerdo de las Condiciones del Servicio de la aplicación.

Recurso de REST: accounts_v1beta.accounts.users

Métodos
create POST /accounts/v1beta/{parent=accounts/*}/users
Crea un usuario de cuenta de Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
Borra un usuario de la cuenta de Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/users/*}
Recupera un usuario de cuenta de Merchant Center.
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
Muestra las preferencias de correo electrónico de un usuario de la cuenta de Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/users
Muestra una lista de todos los usuarios de una cuenta de Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
Actualiza un usuario de la cuenta de Merchant Center.
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
Actualiza las preferencias de correo electrónico de un usuario de la cuenta de Merchant Center.

Recurso de REST: accounts_v1beta.termsOfService

Métodos
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
Acepta un TermsOfService.
get GET /accounts/v1beta/{name=termsOfService/*}
Recupera el TermsOfService asociado con la versión proporcionada.
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
Recupera la versión más reciente del TermsOfService para un kind y una region_code determinados.