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 determinado en tu cuenta de comerciante. Es posible que el LocalInventory tarde hasta una hora en borrarse del producto específico. Una vez que recibas una respuesta de eliminación correcta, espera ese período antes de volver a intentar borrar el elemento.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

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.

Es posible que el recurso LocalInventory nuevo o actualizado tarde hasta 30 minutos en aparecer en los productos.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Muestra una lista de los recursos LocalInventory del producto determinado en tu cuenta de comerciante. Es posible que la respuesta contenga menos elementos que los especificados por pageSize. Si se muestra pageToken en la solicitud anterior, se puede usar para obtener resultados adicionales.

Los recursos de LocalInventory se enumeran por producto para una cuenta determinada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

RegionalInventoryService

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Borra el recurso RegionalInventory especificado del producto determinado en tu cuenta de comerciante. Es posible que el RegionalInventory tarde hasta una hora en borrarse del producto específico. Una vez que recibas una respuesta de eliminación correcta, espera ese período antes de volver a intentar borrar el elemento.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

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.

Es posible que el recurso RegionalInventory nuevo o actualizado tarde hasta 30 minutos en aparecer en los productos.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Muestra una lista de los recursos RegionalInventory del producto determinado en tu cuenta de comerciante. Es posible que la respuesta contenga menos elementos que los especificados por pageSize. Si se muestra pageToken en la solicitud anterior, se puede usar para obtener resultados adicionales.

Los recursos de RegionalInventory se enumeran por producto para una cuenta determinada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

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. Es 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. La cuenta y el producto en los que se insertará este inventario. Formato: accounts/{account}/products/{product}

local_inventory

LocalInventory

Obligatorio. 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. La cuenta y el producto en los que se insertará este inventario. Formato: accounts/{account}/products/{product}

regional_inventory

RegionalInventory

Obligatorio. Es la información del inventario regional que se 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. Es el name del producto superior para el que se enumerarán los inventarios locales. Formato: accounts/{account}/products/{product}

page_size

int32

Es la cantidad máxima de recursos LocalInventory que se mostrarán para el producto determinado. El servicio muestra menos que este valor si la cantidad de inventarios del producto determinado 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 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. Es el token que se muestra 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 del 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. Es el name del producto superior para el que se enumerarán los recursos RegionalInventory. Formato: accounts/{account}/products/{product}

page_size

int32

Es la cantidad máxima de recursos RegionalInventory que se mostrarán para el producto determinado. El servicio muestra menos que este valor si la cantidad de inventarios del producto determinado es menor que pageSize. El valor predeterminado es 25,000. El valor máximo es 100,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 ListRegionalInventories anterior. Proporciona el token de 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. Es el token que se muestra 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 del 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

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 a la que pertenece el producto. Este campo se ignorará si el cliente lo establece.

store_code

string

Obligatorio. Inmutable. Código de tienda (el ID de la tienda de tu Perfil de Negocio) de la tienda física en la que se vende el producto Consulta las especificaciones de datos de 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

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

availability

string

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

quantity

int64

Es la cantidad del producto disponible en esta tienda. Debe ser mayor o igual que cero.

pickup_method

string

Es el 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 de inventario de productos locales.

pickup_sla

string

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

instore_product_location

string

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

RegionalInventory

Información del inventario regional del producto. Representa información específica, como el precio y la disponibilidad de un producto determinado en un region específico. 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 a la que pertenece el producto. Este campo se ignorará si el cliente lo establece.

region

string

Obligatorio. Inmutable. Es el 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

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

availability

string

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