Package google.shopping.merchant.inventories.v1beta

Índice

LocalInventoryService

Servicio para administrar el inventario local de productos

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Borra el LocalInventory especificado del producto especificado en tu cuenta de comerciante. El LocalInventory del producto específico puede tardar hasta una hora en borrarse. Una vez que hayas recibido una respuesta exitosa de eliminación, espera ese período antes de intentar realizar una eliminación nuevamente.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Inserta un recurso LocalInventory en un producto de tu cuenta de comerciante.

Reemplaza el recurso LocalInventory completo si ya existe una entrada con el mismo storeCode para el producto.

El recurso LocalInventory nuevo o actualizado puede tardar hasta 30 minutos en aparecer en los productos.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Enumera los recursos LocalInventory para el producto determinado en tu cuenta de comerciante. La respuesta puede contener menos elementos de los que especifica pageSize. Si se mostró pageToken en la solicitud anterior, se puede usar para obtener resultados adicionales.

Se enumeran LocalInventory recursos por producto para una cuenta determinada.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

RegionalInventoryService

Servicio para administrar el inventario regional de productos. También hay un recurso regions y una API independientes para administrar las definiciones de las regiones.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Borra el recurso RegionalInventory especificado del producto determinado en tu cuenta de comerciante. El RegionalInventory del producto específico puede tardar hasta una hora en borrarse. Una vez que hayas recibido una respuesta exitosa de eliminación, espera ese período antes de intentar realizar una eliminación nuevamente.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Inserta un RegionalInventory en un producto determinado de tu cuenta de comerciante.

Reemplaza el recurso RegionalInventory completo si ya existe una entrada con el mismo region para el producto.

El recurso RegionalInventory nuevo o actualizado puede tardar hasta 30 minutos en aparecer en los productos.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Enumera los recursos RegionalInventory para el producto determinado en tu cuenta de comerciante. La respuesta puede contener menos elementos de los que especifica pageSize. Si se mostró pageToken en la solicitud anterior, se puede usar para obtener resultados adicionales.

Se enumeran RegionalInventory recursos por producto para una cuenta determinada.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta la Descripción general de OAuth 2.0.

DeleteLocalInventoryRequest

Mensaje de la solicitud para el método DeleteLocalInventory.

Campos
name

string

Obligatorio. Es el nombre del inventario local del producto determinado que se borrará. Formato: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Mensaje de la solicitud para el método DeleteRegionalInventory.

Campos
name

string

Obligatorio. El nombre del recurso RegionalInventory que se borrará. Formato: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Mensaje de la solicitud para el método InsertLocalInventory.

Campos
parent

string

Obligatorio. Es la cuenta y el producto en los que se insertará este inventario. Formato: accounts/{account}/products/{product}

local_inventory

LocalInventory

Obligatorio. Es la información del inventario local del producto. Si el producto ya tiene un recurso LocalInventory para el mismo storeCode, se realiza el reemplazo completo del recurso LocalInventory.

InsertRegionalInventoryRequest

Mensaje de la solicitud para el método InsertRegionalInventory.

Campos
parent

string

Obligatorio. Es la cuenta y el producto en los que se insertará este inventario. Formato: accounts/{account}/products/{product}

regional_inventory

RegionalInventory

Obligatorio. Información del inventario regional para agregar al producto. Si el producto ya tiene un recurso RegionalInventory para el mismo region, se realiza el reemplazo completo del recurso RegionalInventory.

ListLocalInventoriesRequest

Mensaje de la solicitud para el método ListLocalInventories.

Campos
parent

string

Obligatorio. El name del producto superior para el que se enumerarán los inventarios locales. Formato: accounts/{account}/products/{product}

page_size

int32

La cantidad máxima de recursos LocalInventory que debe mostrar el producto determinado. El servicio muestra menos que este valor si la cantidad de inventarios para el producto especificado es menor que pageSize. El valor predeterminado es 25,000. El valor máximo es 25,000. Si se especifica un valor superior al máximo, pageSize se establecerá de forma predeterminada en el máximo.

page_token

string

Un token de página, recibido desde una llamada ListLocalInventories anterior. Proporciona el token de la página para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListLocalInventories deben coincidir con la llamada que proporcionó el token de la página. El token que se mostró como nextPageToken en la respuesta a la solicitud anterior.

ListLocalInventoriesResponse

Mensaje de respuesta para el método ListLocalInventories.

Campos
local_inventories[]

LocalInventory

Los recursos LocalInventory para el producto determinado de la cuenta especificada.

next_page_token

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListRegionalInventoriesRequest

Mensaje de la solicitud para el método ListRegionalInventories.

Campos
parent

string

Obligatorio. El name del producto superior para el que se enumeran los recursos RegionalInventory. Formato: accounts/{account}/products/{product}

page_size

int32

La cantidad máxima de recursos RegionalInventory que debe mostrar el producto determinado. El servicio muestra menos que este valor si la cantidad de inventarios para el producto especificado es menor que pageSize. El valor predeterminado es 25,000. El valor máximo es 100000. Si se especifica un valor superior al máximo, el pageSize se establecerá de forma predeterminada en el máximo.

page_token

string

Un token de página, recibido desde una llamada ListRegionalInventories anterior. Proporciona el token de la página para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListRegionalInventories deben coincidir con la llamada que proporcionó el token de la página. El token que se mostró como nextPageToken en la respuesta a la solicitud anterior.

ListRegionalInventoriesResponse

Mensaje de respuesta para el método ListRegionalInventories.

Campos
regional_inventories[]

RegionalInventory

Los recursos RegionalInventory para el producto determinado de la cuenta especificada.

next_page_token

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

LocalInventory

Es la información del inventario local del producto. Representa la información en la tienda de un producto específico en la tienda especificada por storeCode. Para obtener una lista de todos los valores de atributos aceptados, consulta las especificaciones de datos de inventario de productos locales.

Campos
name

string

Solo salida. LocalInventory: el nombre del recurso. Formato: accounts/{account}/products/{product}/localInventories/{store_code}

account

int64

Solo salida. La cuenta propietaria del producto. Se ignorará este campo si lo configura el cliente.

store_code

string

Obligatorio. Inmutable. El código de tienda (el ID de tienda de tu Perfil de Negocio) de la tienda física en la que se vende el producto. Consulta las especificaciones de datos del inventario de productos locales para obtener más información.

price

Price

Es el precio del producto en esta tienda.

sale_price

Price

Es el precio de oferta del producto en esta tienda. Es obligatorio si se define salePriceEffectiveDate.

sale_price_effective_date

Interval

El TimePeriod de la oferta en esta tienda.

custom_attributes[]

CustomAttribute

Una lista de atributos personalizados (proporcionados por el comercio) También puede usar CustomAttribute para enviar cualquier atributo de la especificación de datos en su forma genérica.

availability

string

La disponibilidad del producto en esta tienda. Para conocer los valores de atributos aceptados, consulta las especificaciones de datos del inventario de productos locales.

quantity

int64

Cantidad del producto disponible en esta tienda. Debe ser mayor o igual que cero.

pickup_method

string

Método de retiro admitido para este producto. A menos que el valor sea "not supported", este campo se debe enviar junto con pickupSla. Para conocer los valores de atributos aceptados, consulta las especificaciones de datos del inventario de productos locales.

pickup_sla

string

Es el período relativo a la fecha del pedido de un pedido de este producto de esta tienda, hasta que esté listo para retirarse. Se debe enviar con pickupMethod. Para conocer los valores de atributos aceptados, consulta las especificaciones de datos del inventario de productos locales.

instore_product_location

string

Ubicación del producto dentro de la tienda. La longitud máxima es de 20 bytes.

RegionalInventory

Es la información del inventario regional del producto. Representa información específica, como el precio y la disponibilidad de un producto determinado en una region específica. Para obtener una lista de todos los valores de atributos aceptados, consulta las especificaciones de datos de inventario de productos regionales.

Campos
name

string

Solo salida. RegionalInventory: el nombre del recurso. Formato: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}

account

int64

Solo salida. La cuenta propietaria del producto. Se ignorará este campo si lo configura el cliente.

region

string

Obligatorio. Inmutable. ID de la región para este recurso RegionalInventory. Consulta Disponibilidad y precios regionales para obtener más detalles.

price

Price

Es el precio del producto en esta región.

sale_price

Price

Es el precio de oferta del producto en esta región. Es obligatorio si se define salePriceEffectiveDate.

sale_price_effective_date

Interval

Es el TimePeriod del precio de oferta en esta región.

custom_attributes[]

CustomAttribute

Una lista de atributos personalizados (proporcionados por el comercio) También puede usar CustomAttribute para enviar cualquier atributo de la especificación de datos en su forma genérica.

availability

string

Es la disponibilidad del producto en esta región. Para conocer los valores de atributos aceptados, consulta las especificaciones de datos de inventario de productos regionales.