Package google.shopping.merchant.lfp.v1beta

Índice

LfpInventoryService

Servicio que permite que un socio de LFP envíe inventarios locales para un comercio.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Inserta un recurso LfpInventory para la cuenta del comerciante de destino determinada. Si el recurso ya existe, se reemplazará. El inventario vence automáticamente después de 30 días.

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.

LfpSaleService

Servicio que permite que un socio de LFP envíe datos de ventas de un comercio.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Inserta un LfpSale para el comercio determinado.

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.

LfpStoreService

Servicio que permite que un socio de LFP envíe tiendas locales para un comercio.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Borra una tienda para un comercio de destino.

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.

GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Recupera información sobre una tienda.

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.

InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Inserta una tienda para el comercio de destino. Si ya existe una tienda con el mismo código, se reemplazará.

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.

ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Enumera las tiendas del comercio de destino, especificadas por el filtro en ListLfpStoresRequest.

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.

DeleteLfpStoreRequest

Mensaje de solicitud para el método DeleteLfpStore.

Campos
name

string

Obligatorio. Es el nombre de la tienda que se borrará para la cuenta del comerciante de destino. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Mensaje de la solicitud para el método GetLfpStore.

Campos
name

string

Obligatorio. El nombre de la tienda que se recuperará. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Mensaje de la solicitud para el método InsertLfpInventory.

Campos
parent

string

Obligatorio. La cuenta del proveedor de LFP Formato: accounts/{account}

lfp_inventory

LfpInventory

Obligatorio. El inventario que se insertará.

InsertLfpSaleRequest

Mensaje de solicitud para el método InsertLfpSale.

Campos
parent

string

Obligatorio. La cuenta del proveedor de LFP Formato: accounts/{lfp_partner}

lfp_sale

LfpSale

Obligatorio. La venta que se insertará.

InsertLfpStoreRequest

Mensaje de solicitud para el método InsertLfpStore.

Campos
parent

string

Obligatorio. El formato de la cuenta del proveedor de LFP: accounts/{account}

lfp_store

LfpStore

Obligatorio. La tienda que se insertará.

LfpInventory

Es el inventario local del comercio.

Campos
name

string

Solo salida. Identificador. Es el nombre del recurso LfpInventory. Formato: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}

target_account

int64

Obligatorio. Es el ID de Merchant Center del comercio para el que se enviará el inventario.

store_code

string

Obligatorio. Es el identificador de la tienda del comercio. El código de tienda que se inserta a través de InsertLfpStore o el código de tienda en el Perfil de Negocio

offer_id

string

Obligatorio. Inmutable. Es un identificador único para el producto. Si se envían inventarios y ventas para un comercio, este ID debe coincidir con el mismo producto.

Nota: Si el comercio vende el mismo producto nuevo y usado, los IDs deben ser diferentes.

region_code

string

Obligatorio. Es el código de territorio de CLDR del país donde se vende el producto.

content_language

string

Obligatorio. El código de idioma ISO 639-1 de dos letras del artículo.

price

Price

Opcional. Es el precio actual del producto.

availability

string

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

collection_time

Timestamp

Opcional. Es el momento en que se recopila el inventario. Si no la estableces, se establecerá en la hora en la que se envíe el inventario.

gtin

string

Opcional. Es el código comercial global de artículo del producto.

quantity

int64

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

pickup_method

string

Opcional. Método de retiro admitido para esta oferta. A menos que el valor sea "no admitido", 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

Opcional. Fecha prevista a partir de la cual se podrá retirar un pedido en relación con la fecha del pedido. Se deben enviar junto con pickupMethod. Para conocer los valores de atributos aceptados, consulta las especificaciones de datos del inventario de productos locales.

feed_label

string

Opcional. Es la etiqueta de feed del producto. Si no la estableces, el valor predeterminado será regionCode.

LfpSale

Es una venta para el comercio.

Campos
name

string

Solo salida. Identificador. LfpSale: el nombre del recurso. Formato: accounts/{account}/lfpSales/{sale}

target_account

int64

Obligatorio. Es el ID de Merchant Center del comercio para el que se envía la oferta.

store_code

string

Obligatorio. Es el identificador de la tienda del comercio. Una storeCode insertada a través de la API o con el código de la tienda en el Perfil de Negocio.

offer_id

string

Obligatorio. Es un identificador único para el producto. Si se envían inventarios y ventas para un comercio, este ID debe coincidir con el mismo producto.

Nota: Si el comercio vende el mismo producto nuevo y usado, los IDs deben ser diferentes.

region_code

string

Obligatorio. Es el código de territorio de CLDR del país donde se vende el producto.

content_language

string

Obligatorio. El código de idioma ISO 639-1 de dos letras del artículo.

gtin

string

Obligatorio. Es el código comercial global de artículo del producto vendido.

price

Price

Obligatorio. Es el precio unitario del producto.

quantity

int64

Obligatorio. El cambio relativo de la cantidad disponible. Negativo para artículos devueltos.

sale_time

Timestamp

Obligatorio. La marca de tiempo de la oferta.

uid

string

Solo salida. Es un ID único global generado por el sistema para LfpSale.

feed_label

string

Opcional. Es la etiqueta de feed del producto. Si no la estableces, el valor predeterminado será regionCode.

LfpStore

Es una tienda para el comercio. Se usará para establecer coincidencias con una tienda del Perfil de Negocio de Google del comercio objetivo. Si no se encuentra una tienda coincidente, no se utilizarán los inventarios ni las ventas que se enviaron con el código de tienda.

Campos
name

string

Solo salida. Identificador. LfpStore: el nombre del recurso. Formato: accounts/{account}/lfpStores/{target_merchant}~{store_code}

target_account

int64

Obligatorio. Es el ID de Merchant Center del comercio para el que se envía la tienda.

store_code

string

Obligatorio. Inmutable. Es un identificador de tienda único para el comercio de destino.

store_address

string

Obligatorio. Es la dirección de la tienda. Ejemplo: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, EE.UU.

gcid_category[]

string

Opcional. ID de categoría de Google Mi Negocio.

matching_state

StoreMatchingState

Opcional. Solo salida. Es el estado de la coincidencia con un Perfil de Negocio de Google. Si no se encuentra ninguna coincidencia, consulta matchingStateHint para obtener más información.

store_name

string

Opcional. Es el nombre del comercio o de la tienda.

phone_number

string

Opcional. Es el número de teléfono de la tienda en formato E.164. Ejemplo: +15556767888

website_uri

string

Opcional. Es la URL del sitio web de la tienda o el comercio.

place_id

string

Opcional. Es el ID de Google Place de la ubicación de la tienda.

matching_state_hint

string

Opcional. Solo salida. Sugerencia de por qué falló la coincidencia. Esto solo se establece cuando matchingState=STORE_MATCHING_STATE_FAILED.

Los valores posibles son:

  • linked-store-not-found”: No hay tiendas del Perfil de Negocio de Google disponibles que coincidan.
  • store-match-not-found”: No se pudo vincular el LfpStore proporcionado con ninguna de las tiendas conectadas del Perfil de Negocio de Google. La cuenta de Merchant Center está conectada correctamente y las tiendas están disponibles en el Perfil de Negocio de Google, pero la dirección de la ubicación de LfpStore no coincide con las direcciones de las tiendas del Perfil de Negocio de Google. Actualiza la dirección de LfpStore o la de la tienda del Perfil de Negocio de Google para que coincida correctamente.
  • store-match-unverified”: No se pudo vincular la LfpStore proporcionada con ninguna de las tiendas conectadas del Perfil de Negocio de Google, ya que no está verificada la tienda correspondiente del Perfil de Negocio de Google. Completa el proceso de verificación del Perfil de Negocio de Google para que la coincidencia sea correcta.

StoreMatchingState

El estado de coincidencia de LfpStore con un Perfil de Negocio de Google.

Enumeradores
STORE_MATCHING_STATE_UNSPECIFIED Estado de coincidencia de la tienda sin especificar.
STORE_MATCHING_STATE_MATCHED La LfpStore coincide correctamente con una tienda del Perfil de Negocio de Google.
STORE_MATCHING_STATE_FAILED La LfpStore no coincide con una tienda del Perfil de Negocio de Google.

ListLfpStoresRequest

Mensaje de solicitud para el método ListLfpStores.

Campos
parent

string

Obligatorio. El socio de LFP Formato: accounts/{account}

target_account

int64

Obligatorio. Es el ID de Merchant Center del comercio para el que se enumeran las tiendas.

page_size

int32

Opcional. La cantidad máxima de LfpStore recursos que debe mostrar la cuenta determinada. El servicio muestra menos que este valor si la cantidad de tiendas para la cuenta determinada es inferior a pageSize. El valor predeterminado es 250. El valor máximo es 1,000. Si se especifica un valor superior al máximo, pageSize se establecerá de forma predeterminada en el valor máximo.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListLfpStoresRequest anterior. Proporciona el token de la página para recuperar la página siguiente. Cuando se utiliza la paginación, todos los demás parámetros proporcionados a ListLfpStoresRequest 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.

ListLfpStoresResponse

Mensaje de respuesta para el método ListLfpStores.

Campos
lfp_stores[]

LfpStore

Son las tiendas del comercio especificado.

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.