Índice
AccountIssueService
(interfaz)AccountsService
(interfaz)AutofeedSettingsService
(interfaz)BusinessIdentityService
(interfaz)BusinessInfoService
(interfaz)EmailPreferencesService
(interfaz)HomepageService
(interfaz)OnlineReturnPolicyService
(interfaz)ProgramsService
(interfaz)RegionsService
(interfaz)ShippingSettingsService
(interfaz)TermsOfServiceAgreementStateService
(interfaz)TermsOfServiceService
(interfaz)UserService
(interfaz)AcceptTermsOfServiceRequest
(mensaje)Accepted
(mensaje)AccessRight
(enumeración)Account
(mensaje)AccountAggregation
(mensaje)AccountIssue
(mensaje)AccountIssue.ImpactedDestination
(mensaje)AccountIssue.ImpactedDestination.Impact
(mensaje)AccountIssue.Severity
(enumeración)Address
(mensaje)AutofeedSettings
(mensaje)BusinessDayConfig
(mensaje)BusinessDayConfig.Weekday
(enumeración)BusinessIdentity
(mensaje)BusinessIdentity.IdentityAttribute
(mensaje)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(enumeración)BusinessIdentity.PromotionsConsent
(enumeración)BusinessInfo
(mensaje)CarrierRate
(mensaje)ClaimHomepageRequest
(mensaje)CreateAndConfigureAccountRequest
(mensaje)CreateAndConfigureAccountRequest.AddAccountService
(mensaje)CreateAndConfigureAccountRequest.AddUser
(mensaje)CreateRegionRequest
(mensaje)CreateUserRequest
(mensaje)CustomerService
(mensaje)CutoffTime
(mensaje)DeleteAccountRequest
(mensaje)DeleteRegionRequest
(mensaje)DeleteUserRequest
(mensaje)DeliveryTime
(mensaje)DisableProgramRequest
(mensaje)Distance
(mensaje)Distance.Unit
(enumeración)EmailPreferences
(mensaje)EmailPreferences.OptInState
(enumeración)EnableProgramRequest
(mensaje)GetAccountRequest
(mensaje)GetAutofeedSettingsRequest
(mensaje)GetBusinessIdentityRequest
(mensaje)GetBusinessInfoRequest
(mensaje)GetEmailPreferencesRequest
(mensaje)GetHomepageRequest
(mensaje)GetOnlineReturnPolicyRequest
(mensaje)GetProgramRequest
(mensaje)GetRegionRequest
(mensaje)GetShippingSettingsRequest
(mensaje)GetTermsOfServiceAgreementStateRequest
(mensaje)GetTermsOfServiceRequest
(mensaje)GetUserRequest
(mensaje)Headers
(mensaje)Homepage
(mensaje)InsertShippingSettingsRequest
(mensaje)ListAccountIssuesRequest
(mensaje)ListAccountIssuesResponse
(mensaje)ListAccountsRequest
(mensaje)ListAccountsResponse
(mensaje)ListOnlineReturnPoliciesRequest
(mensaje)ListOnlineReturnPoliciesResponse
(mensaje)ListProgramsRequest
(mensaje)ListProgramsResponse
(mensaje)ListRegionsRequest
(mensaje)ListRegionsResponse
(mensaje)ListSubAccountsRequest
(mensaje)ListSubAccountsResponse
(mensaje)ListUsersRequest
(mensaje)ListUsersResponse
(mensaje)LocationIdSet
(mensaje)MinimumOrderValueTable
(mensaje)MinimumOrderValueTable.StoreCodeSetWithMov
(mensaje)OnlineReturnPolicy
(mensaje)OnlineReturnPolicy.ItemCondition
(enumeración)OnlineReturnPolicy.Policy
(mensaje)OnlineReturnPolicy.Policy.Type
(enumeración)OnlineReturnPolicy.RestockingFee
(mensaje)OnlineReturnPolicy.ReturnMethod
(enumeración)OnlineReturnPolicy.ReturnShippingFee
(mensaje)OnlineReturnPolicy.ReturnShippingFee.Type
(enumeración)OnlineReturnPolicy.SeasonalOverride
(mensaje)PhoneVerificationState
(enumeración)Program
(mensaje)Program.Requirement
(mensaje)Program.State
(enumeración)RateGroup
(mensaje)Region
(mensaje)Region.GeoTargetArea
(mensaje)Region.PostalCodeArea
(mensaje)Region.PostalCodeArea.PostalCodeRange
(mensaje)Required
(mensaje)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(mensaje)RetrieveLatestTermsOfServiceRequest
(mensaje)Row
(mensaje)Service
(mensaje)Service.LoyaltyProgram
(mensaje)Service.LoyaltyProgram.LoyaltyProgramTiers
(mensaje)Service.ShipmentType
(enumeración)Service.StoreConfig
(mensaje)Service.StoreConfig.CutoffConfig
(mensaje)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(mensaje)Service.StoreConfig.StoreServiceType
(enumeración)ShippingSettings
(mensaje)Table
(mensaje)TermsOfService
(mensaje)TermsOfServiceAgreementState
(mensaje)TermsOfServiceKind
(enumeración)TransitTable
(mensaje)TransitTable.TransitTimeRow
(mensaje)TransitTable.TransitTimeRow.TransitTimeValue
(mensaje)UnclaimHomepageRequest
(mensaje)UpdateAccountRequest
(mensaje)UpdateAutofeedSettingsRequest
(mensaje)UpdateBusinessIdentityRequest
(mensaje)UpdateBusinessInfoRequest
(mensaje)UpdateEmailPreferencesRequest
(mensaje)UpdateHomepageRequest
(mensaje)UpdateRegionRequest
(mensaje)UpdateUserRequest
(mensaje)User
(mensaje)User.State
(enumeración)Value
(mensaje)Warehouse
(mensaje)WarehouseBasedDeliveryTime
(mensaje)WarehouseCutoffTime
(mensaje)
AccountIssueService
Servicio para admitir la API de AccountIssueService
.
ListAccountIssues |
---|
Muestra una lista de todos los problemas de una cuenta de Merchant Center.
|
AccountsService
Servicio para admitir la API de Accounts.
CreateAndConfigureAccount |
---|
Crea una cuenta independiente de Merchant Center con configuración adicional. Agrega al usuario que realiza la solicitud como administrador de la cuenta nueva.
|
DeleteAccount |
---|
Borra la cuenta especificada, independientemente de su tipo: independiente, MCA o cuenta secundaria. Si borras una MCA, se borrarán todas sus cuentas secundarias. Para ejecutar este método, se requiere acceso de administrador. La eliminación se realiza correctamente solo si la cuenta no proporciona servicios a ninguna otra cuenta y no tiene ofertas procesadas. Puedes usar el parámetro
|
GetAccount |
---|
Recupera una cuenta de tu cuenta de Merchant Center. Después de insertar, actualizar o borrar una cuenta, es posible que los cambios demoren varios minutos en aplicarse.
|
ListAccounts |
---|
Muestra 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. Esto no solo muestra las cuentas secundarias de una MCA, sino todas las cuentas a las que tiene acceso el usuario que realiza la llamada, incluidas otras MCA, cuentas vinculadas, cuentas independientes, etcétera. Si no se proporciona ningún filtro, se muestran las cuentas a las que se agregó directamente el usuario. Este método tiene coherencia eventual, lo que significa que es posible que los cambios, como la creación o actualización de una cuenta, o un cambio de relaciones entre cuentas, no aparezcan en los resultados de inmediato. En cambio, estos cambios se propagan durante un período breve, después del cual la información actualizada puede coincidir con los predicados asociados. Esto significa que, si buscas por nombre de cuenta, es posible que no se muestre una cuenta que se haya modificado recientemente, aunque satisfaga el predicado.
|
ListSubAccounts |
---|
Muestra una lista de todas las cuentas secundarias de una cuenta de varios clientes determinada. Este es un wrapper de conveniencia para el método
|
UpdateAccount |
---|
Actualiza una cuenta independientemente de su tipo: independiente, MCA o cuenta secundaria. Para ejecutar este método, se requiere acceso de administrador.
|
AutofeedSettingsService
Servicio para admitir la configuración de alimentación automática.
GetAutofeedSettings |
---|
Recupera la configuración del feed automático de una cuenta.
|
UpdateAutofeedSettings |
---|
Actualiza la configuración del feed automático de una cuenta.
|
BusinessIdentityService
Servicio para admitir la API de identidad de la empresa.
GetBusinessIdentity |
---|
Recupera la identidad de la empresa de una cuenta.
|
UpdateBusinessIdentity |
---|
Actualiza la identidad de la empresa de una cuenta. Para ejecutar este método, se requiere acceso de administrador.
|
BusinessInfoService
Servicio para admitir la API de información de la empresa.
GetBusinessInfo |
---|
Recupera la información de la empresa de una cuenta.
|
UpdateBusinessInfo |
---|
Actualiza la información de la empresa de una cuenta. Para ejecutar este método, se requiere acceso de administrador.
|
EmailPreferencesService
Servicio para admitir la API de EmailPreferences
.
GetEmailPreferences |
---|
Muestra las preferencias de correo electrónico de un usuario de una cuenta de Merchant Center. Este servicio solo permite recuperar y actualizar las preferencias de correo electrónico del usuario autenticado. Usa el alias name=accounts/*/users/me/emailPreferences para obtener las preferencias del usuario autenticado.
|
UpdateEmailPreferences |
---|
Actualiza las preferencias de correo electrónico de un usuario de una cuenta de Merchant Center. Los usuarios de la MCA deben especificar la cuenta de la MCA en lugar de una cuenta secundaria de la MCA. No se actualizarán las preferencias que no se seleccionen de forma explícita en la máscara de actualización. No es válido que las actualizaciones especifiquen un valor de estado de habilitación NO CONFIRMADO. Usa el alias name=accounts/*/users/me/emailPreferences para actualizar las preferencias del usuario autenticado.
|
HomepageService
Servicio para admitir una API para la página principal de una tienda.
ClaimHomepage |
---|
Reclama la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador. Si la página principal ya se reclamó, se volverá a verificar la verificación (a menos que el comercio esté exento de reclamar, lo que también lo exime de la verificación) y se mostrará una respuesta correcta. Si ya no se puede verificar la propiedad, se mostrará un error, pero no se borrará el reclamo. En caso de que se produzca un error, se mostrará un mensaje de error canónico: * PERMISSION_DENIED: El usuario no tiene los permisos necesarios en esta cuenta de MC. * FAILED_PRECONDITION: - La cuenta no es una cuenta de Merchant Center. - La cuenta de MC no tiene una página principal. - El reclamo falló (en este caso, el mensaje de error contendrá más detalles).
|
GetHomepage |
---|
Recupera la página principal de una tienda.
|
UnclaimHomepage |
---|
Cancela la reclamación de la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador.
|
UpdateHomepage |
---|
Actualiza la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador.
|
OnlineReturnPolicyService
El servicio facilita la administración de la configuración de la política de devoluciones por arrepentimiento de un comercio, lo que abarca las políticas de devoluciones de los anuncios y las fichas gratuitas.
programas. Esta API define el siguiente modelo de recursos:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
Obtiene una política de devoluciones existente para un comercio determinado.
|
ListOnlineReturnPolicies |
---|
Muestra todas las políticas de devoluciones existentes de un comercio determinado.
|
ProgramsService
Servicio para la administración de programas.
Los programas proporcionan un mecanismo para agregar funciones a las cuentas de comerciante. Un ejemplo típico de esto es el programa de fichas de productos gratuitas, que permite que los productos de la tienda de un comercio se muestren en Google de forma gratuita.
Este servicio expone métodos para recuperar la participación de un comercio en todos los programas disponibles, además de métodos para habilitar o inhabilitar de forma explícita la participación en cada programa.
DisableProgram |
---|
Inhabilita la participación en el programa especificado para la cuenta. Para ejecutar este método, se requiere acceso de administrador.
|
EnableProgram |
---|
Habilita la participación en el programa especificado para la cuenta. Para ejecutar este método, se requiere acceso de administrador.
|
GetProgram |
---|
Recupera el programa especificado para la cuenta.
|
ListPrograms |
---|
Recupera todos los programas de la cuenta.
|
RegionsService
Administra la configuración de las regiones.
Esta API define el siguiente modelo de recursos:
Region
CreateRegion |
---|
Crea una definición de región en tu cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.
|
DeleteRegion |
---|
Borra la definición de una región de tu cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.
|
GetRegion |
---|
Recupera una región definida en tu cuenta de Merchant Center.
|
ListRegions |
---|
Muestra las regiones de tu cuenta de Merchant Center.
|
UpdateRegion |
---|
Actualiza la definición de una región en tu cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.
|
ShippingSettingsService
Servicio para obtener información de configuración de envío de llamadas de método por método de la API de Merchant.
GetShippingSettings |
---|
Recupera información de la configuración de envío.
|
InsertShippingSettings |
---|
Reemplaza la configuración de envío de un comercio por la configuración de envío de la solicitud. Para ejecutar este método, se requiere acceso de administrador.
|
TermsOfServiceAgreementStateService
Servicio para admitir la API de TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Muestra el estado de un acuerdo de las Condiciones del Servicio.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
Recupera el estado del acuerdo de las Condiciones del Servicio de la aplicación.
|
TermsOfServiceService
Servicio para admitir la API de TermsOfService
.
AcceptTermsOfService |
---|
Acepta un
|
GetTermsOfService |
---|
Recupera el
|
RetrieveLatestTermsOfService |
---|
Recupera la versión más reciente de
|
UserService
Servicio para admitir la API de usuario.
CreateUser |
---|
Crea un usuario de la cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.
|
DeleteUser |
---|
Borra un usuario de la cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador. El usuario que se borrará no puede ser el último usuario administrador de esa cuenta. Además, un usuario está protegido contra la eliminación si lo administra el Administrador de Negocio".
|
GetUser |
---|
Recupera un usuario de una cuenta de Merchant Center.
|
ListUsers |
---|
Muestra una lista de todos los usuarios de una cuenta de Merchant Center.
|
UpdateUser |
---|
Actualiza un usuario de la cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.
|
AcceptTermsOfServiceRequest
Mensaje de la solicitud para el método AcceptTermsOfService
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: |
account |
Obligatorio. La cuenta para la que se aceptan las Condiciones del Servicio |
region_ |
Obligatorio. Es el código de región según se define en CLDR. Es un país cuando las Condiciones del Servicio se aplican específicamente a ese país o 001 cuando se aplican a nivel global. |
Aceptado
Describe las Condiciones del Servicio aceptadas.
Campos | |
---|---|
terms_ |
Los termsOfService aceptados. |
accepted_ |
Es la cuenta en la que se registró la aceptación. Puede ser la cuenta en sí o, en el caso de las cuentas secundarias, la cuenta de la MCA. |
valid_ |
Cuando se establece, se indica que las TermsOfService aceptadas solo son válidas hasta el final de esta fecha (en UTC). Se debe aceptar una nueva antes de esa fecha. La información de los TermsOfService obligatorios se encuentra en el mensaje Required. |
AccessRight
El derecho de acceso
Enumeraciones | |
---|---|
ACCESS_RIGHT_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
STANDARD |
Derechos de acceso estándar. |
ADMIN |
Derechos de acceso de administrador |
PERFORMANCE_REPORTING |
Los usuarios con este derecho tienen acceso al rendimiento y las estadísticas. |
Cuenta
El mensaje Account
representa la cuenta de un comercio en los anuncios de Shopping. Es la entidad principal para administrar los datos de productos, la configuración y las interacciones con los servicios de Google y los proveedores externos.
Las cuentas pueden funcionar como entidades independientes o formar parte de una estructura de cuenta de varios clientes (MCA). En una configuración de MCA, la cuenta superior administra varias cuentas secundarias.
Para establecer una cuenta, debes configurar atributos como el nombre de la cuenta, la zona horaria y las preferencias de idioma.
El mensaje Account
es la entidad superior de muchos otros recursos, por ejemplo, AccountRelationship
, Homepage
, BusinessInfo
, etcétera.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la cuenta. Formato: |
account_ |
Solo salida. Es el ID de la cuenta. |
account_ |
Obligatorio. Es el nombre legible de la cuenta. Consulta nombre de la tienda y nombre de la empresa para obtener más información. |
adult_ |
Si la cuenta incluye contenido para adultos |
test_ |
Solo salida. Indica si se trata de una cuenta de prueba. |
time_ |
Obligatorio. Es la zona horaria de la cuenta. En las operaciones de escritura, Para las operaciones de lectura, |
language_ |
Obligatorio. El código de idioma BCP-47 de la cuenta, como |
AccountAggregation
Este tipo no tiene campos.
Carga útil AccountAggregation
.
AccountIssue
Un AccountIssue
.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso del problema de la cuenta. Formato: |
title |
Es el título localizado del problema. |
severity |
La gravedad general del problema. |
impacted_ |
El impacto que tiene este problema en varios destinos |
detail |
Más detalles localizados sobre el problema. |
documentation_ |
Vínculo al Centro de ayuda de Merchant Center que proporciona más información sobre el problema y cómo solucionarlo |
ImpactedDestination
El impacto del problema en un destino
Campos | |
---|---|
impacts[] |
El impacto (negativo) de varias regiones en el destino determinado. |
reporting_ |
El contexto de informes afectado |
Impacto
El impacto del problema en una región
Campos | |
---|---|
region_ |
Es el código de región de CLDR en el que se aplica este problema. |
severity |
La gravedad del problema en el destino y la región |
Gravedad
Todos los niveles de gravedad posibles
Enumeraciones | |
---|---|
SEVERITY_UNSPECIFIED |
Se desconoce la gravedad. |
CRITICAL |
El problema hace que las ofertas no se publiquen. |
ERROR |
El problema podría afectar las ofertas (en el futuro) o ser un indicador de problemas con las ofertas. |
SUGGESTION |
El problema es una sugerencia para mejorar. |
Dirección
Es la dirección de envío del almacén.
Campos | |
---|---|
street_ |
Es la parte de la dirección a nivel de la calle. Por ejemplo: |
city |
Obligatorio. Ciudad, pueblo o comuna También puede incluir localidades o sublocalidades dependientes (por ejemplo, vecindarios o suburbios). |
administrative_ |
Obligatorio. Es la subdivisión administrativa principal del país. Por ejemplo, un estado como California ("CA") o una provincia como Quebec ("QC"). |
postal_ |
Obligatorio. Código postal (por ejemplo, “94043”). |
region_ |
Obligatorio. Código de país de CLDR (por ejemplo, “US”). |
AutofeedSettings
Recopilación de información relacionada con la configuración del feed automático.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la configuración del feed automático. Formato: |
enable_ |
Obligatorio. Habilita o inhabilita el rastreo de productos a través del feed automático de la cuenta determinada. Las cuentas de feeds automáticos deben cumplir con ciertas condiciones, que se pueden verificar a través del campo |
eligible |
Solo salida. Determina si el comercio es apto para inscribirse en un feed automático. |
BusinessDayConfig
Son los días hábiles del almacén.
Campos | |
---|---|
business_ |
Obligatorio. Días hábiles normales. No puede estar vacío. |
Día de semana
Enumeraciones | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
BusinessIdentity
Recopilación de información relacionada con la identidad de una empresa.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la identidad de la empresa. Formato: |
promotions_ |
Obligatorio. Si los atributos de identidad se pueden usar para promociones. |
black_ |
Opcional. Especifica si la empresa se identifica como de propiedad de personas negras. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en |
women_ |
Opcional. Especifica si la empresa se identifica como una empresa de mujeres. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en |
veteran_ |
Opcional. Especifica si la empresa se identifica como de propiedad de veteranos. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en |
latino_ |
Opcional. Especifica si la empresa se identifica como de propiedad latina. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en |
small_ |
Opcional. Especifica si la empresa se identifica como una pequeña empresa. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en |
IdentityAttribute
Toda la información relacionada con un atributo de identidad.
Campos | |
---|---|
identity_ |
Obligatorio. La declaración de identidad de este atributo. |
IdentityDeclaration
Todos los parámetros de configuración posibles relacionados con la declaración de una identidad
Enumeraciones | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
Es el valor predeterminado que indica que no se realizó ninguna selección. |
SELF_IDENTIFIES_AS |
Indica que la cuenta se identifica con el atributo. |
DOES_NOT_SELF_IDENTIFY_AS |
Indica que la cuenta no se identifica con el atributo. |
PromotionsConsent
Todos los parámetros de configuración posibles relacionados con las promociones de la identidad de la empresa
Enumeraciones | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
Es el valor predeterminado que indica que no se realizó ninguna selección. |
PROMOTIONS_CONSENT_GIVEN |
Indica que la cuenta dio su consentimiento para que se use su identidad comercial para promociones. |
PROMOTIONS_CONSENT_DENIED |
Indica que la cuenta no dio su consentimiento para que se use su identidad comercial en promociones. |
BusinessInfo
El mensaje BusinessInfo
contiene información esencial sobre la empresa de un comercio.
Este mensaje captura detalles clave de la empresa, como la dirección física, los contactos del servicio de atención al cliente y los identificadores específicos de la región.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la información de la empresa. Formato: |
address |
Opcional. Es la dirección de la empresa. Solo se admiten los campos |
phone |
Solo salida. El número de teléfono de la empresa |
phone_ |
Solo salida. El estado de verificación telefónica de la empresa |
customer_ |
Opcional. El servicio de atención al cliente de la empresa. |
korean_ |
Opcional. El número de registro comercial coreano de 10 dígitos separado por guiones con el formato XXX-XX-XXXXX |
CarrierRate
Es una lista de tarifas de operadores a las que se puede hacer referencia con main_table
o single_value
. Los servicios de operadores admitidos se definen en https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la tarifa del operador. Debe ser único por grupo de tarifas. |
carrier |
Obligatorio. Servicio de operador, como |
carrier_ |
Obligatorio. Servicio de operador, como |
origin_ |
Obligatorio. Es el origen de envío para esta tarifa del transportista. |
percentage_ |
Opcional. Es el modificador multiplicativo de la tarifa de envío como un número en notación decimal. Puede ser negativo. Por ejemplo, |
flat_ |
Opcional. Es un modificador aditivo de la tarifa de envío. Puede ser negativo. Por ejemplo, |
ClaimHomepageRequest
Mensaje de la solicitud para el método ClaimHomepage
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la página principal que se reclamará. Formato: |
overwrite |
Opcional. Cuando se establece en |
CreateAndConfigureAccountRequest
Mensaje de la solicitud para el método CreateAndConfigureAccount
.
Campos | |
---|---|
account |
Obligatorio. La cuenta que se creará. |
users[] |
Opcional. Usuarios que se agregarán a la cuenta. Este campo dejó de estar disponible y no existirá después de que la API deje de estar en versión beta. En su lugar, usa el campo |
user[] |
Opcional. Usuarios que se agregarán a la cuenta. |
service[] |
Obligatorio. Como parte de la creación, se inicializa un servicio de cuenta entre la cuenta que se creará y la cuenta del proveedor. Se debe proporcionar al menos uno de esos servicios. Actualmente, exactamente uno de ellos debe ser |
AddAccountService
Instrucciones adicionales para agregar servicios de la cuenta durante la creación de la cuenta.
Campos | |
---|---|
Campo de unión service_type . Es el tipo de servicio que se agregará. Las direcciones (service_type ) solo pueden ser una de las siguientes opciones: |
|
account_ |
El proveedor es un agregador de la cuenta. Carga útil para el tipo de servicio Account Aggregation. |
provider |
Obligatorio. El proveedor del servicio. La referencia a una cuenta, como |
AddUser
Instrucción para agregar un usuario a la cuenta durante su creación.
Campos | |
---|---|
user_ |
Obligatorio. Es la dirección de correo electrónico del usuario (por ejemplo, |
user |
Opcional. Detalles sobre el usuario que se agregará. Por el momento, solo se pueden especificar los derechos de acceso. |
CreateRegionRequest
Mensaje de la solicitud para el método CreateRegion
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta para la que se creará una región. Formato: |
region_ |
Obligatorio. Es el identificador de la región, único en todas las regiones de la misma cuenta. |
region |
Obligatorio. La región que se creará. |
CreateUserRequest
Mensaje de la solicitud para el método CreateUser
.
Campos | |
---|---|
parent |
Obligatorio. Es el nombre del recurso de la cuenta para la que se creará un usuario. Formato: |
user_ |
Obligatorio. Es la dirección de correo electrónico del usuario (por ejemplo, |
user |
Opcional. El usuario que se creará. |
CustomerService
Información de atención al cliente
Campos | |
---|---|
uri |
Opcional. Es el URI en el que se puede encontrar el servicio de atención al cliente. |
email |
Opcional. La dirección de correo electrónico a la que se puede comunicar el servicio de atención al cliente. |
phone |
Opcional. Es el número de teléfono al que se puede llamar para comunicarse con el servicio de atención al cliente. |
CutoffTime
Definición del horario límite de los días hábiles.
Campos | |
---|---|
hour |
Obligatorio. Es la hora del horario límite hasta la que se debe realizar un pedido para que se procese el mismo día. |
minute |
Obligatorio. Es el minuto del horario límite hasta el que se debe realizar un pedido para que se procese el mismo día. |
time_ |
Obligatorio. Identificador de zona horaria. Por ejemplo, "Europe/Zurich". |
DeleteAccountRequest
Mensaje de la solicitud para el método DeleteAccount
.
Campos | |
---|---|
name |
Obligatorio. El nombre de la cuenta que se borrará. Formato: |
force |
Opcional. Si se establece en |
DeleteRegionRequest
Mensaje de la solicitud para el método DeleteRegion
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la región que se borrará. Formato: |
DeleteUserRequest
Mensaje de la solicitud para el método DeleteUser
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del usuario que se borrará. Formato: También es posible borrar al usuario correspondiente al llamador usando |
DeliveryTime
Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.
Campos | |
---|---|
warehouse_ |
Opcional. Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se establece, no se debe configurar ningún otro campo relacionado con el tiempo en tránsito en [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min_ |
Es la cantidad mínima de días hábiles que se tarda en el envío. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. Se debe configurar |
max_ |
Es la cantidad máxima de días hábiles que se pasan en tránsito. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. Debe ser mayor o igual que |
cutoff_ |
Definición del horario límite de los días hábiles. Si no se configura, la hora límite se establecerá de forma predeterminada a las 8 a.m. (PST). |
min_ |
Es la cantidad mínima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. "min_handling_days" y "max_handling_days" deben configurarse o no al mismo tiempo. |
max_ |
Es la cantidad máxima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. Debe ser mayor o igual que |
transit_ |
Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de filas y columnas Se puede configurar |
handling_ |
Son los días hábiles durante los cuales se pueden procesar los pedidos. Si no se proporciona, se supondrán días hábiles de lunes a viernes. |
transit_ |
Son los días hábiles durante los cuales los pedidos pueden estar en tránsito. Si no se proporciona, se supondrán días hábiles de lunes a viernes. |
DisableProgramRequest
Mensaje de solicitud para el método DisableProgram.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del programa para el que se inhabilitará la participación de la cuenta determinada. Formato: |
Distancia
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local.
Campos | |
---|---|
value |
Es el valor de número entero de la distancia. |
unit |
La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros. |
Unidad
La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros.
Enumeraciones | |
---|---|
UNIT_UNSPECIFIED |
Unidad no especificada |
MILES |
Unidad en millas |
KILOMETERS |
Unidad en kilómetros |
EmailPreferences
Las categorías de notificaciones que el usuario habilitó o inhabilitó Las preferencias de correo electrónico no incluyen anuncios obligatorios, ya que los usuarios no pueden inhabilitarlos.
Campos | |
---|---|
name |
Identificador. Es el nombre de EmailPreferences. El extremo solo es compatible con el usuario autenticado. |
news_ |
Opcional. Actualizaciones sobre funciones nuevas, sugerencias y prácticas recomendadas |
OptInState
Estado de habilitación de la preferencia de correo electrónico
Enumeraciones | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
No se especifica el estado de habilitación. |
OPTED_OUT |
El usuario inhabilitó la recepción de este tipo de correo electrónico. |
OPTED_IN |
El usuario aceptó recibir este tipo de correo electrónico. |
UNCONFIRMED |
El usuario aceptó recibir este tipo de correo electrónico y se le envió el correo electrónico de confirmación, pero aún no lo confirmó (solo se aplica a ciertos países). |
EnableProgramRequest
Es un mensaje de solicitud para el método EnableProgram.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del programa para el que se habilitará la participación de la cuenta determinada. Formato: |
GetAccountRequest
Mensaje de la solicitud para el método GetAccount
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la cuenta que se recuperará. Formato: |
GetAutofeedSettingsRequest
Mensaje de la solicitud para el método GetAutofeedSettings
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del recurso de la configuración del feed automático. Formato: |
GetBusinessIdentityRequest
Mensaje de la solicitud para el método GetBusinessIdentity
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del recurso de la identidad de la empresa. Formato: |
GetBusinessInfoRequest
Mensaje de la solicitud para el método GetBusinessInfo
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del recurso de la información de la empresa. Formato: |
GetEmailPreferencesRequest
Mensaje de solicitud para el método GetEmailPreferences.
Campos | |
---|---|
name |
Obligatorio. |
GetHomepageRequest
Mensaje de la solicitud para el método GetHomepage
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la página principal que se recuperará. Formato: |
GetOnlineReturnPolicyRequest
Mensaje de la solicitud para el método GetOnlineReturnPolicy
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la política de devoluciones que se recuperará. Formato: |
GetProgramRequest
Mensaje de solicitud para el método GetProgram.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del programa que se recuperará. Formato: |
GetRegionRequest
Mensaje de la solicitud para el método GetRegion
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la región que se recuperará. Formato: |
GetShippingSettingsRequest
Mensaje de la solicitud para el método GetShippingSetting
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la configuración de envío que se recuperará. Formato: |
GetTermsOfServiceAgreementStateRequest
Mensaje de la solicitud para el método GetTermsOfServiceAgreementState
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: |
GetTermsOfServiceRequest
Mensaje de la solicitud para el método GetTermsOfService
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: |
GetUserRequest
Mensaje de la solicitud para el método GetUser
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del usuario que se recuperará. Formato: También es posible recuperar el usuario correspondiente al llamador usando |
Encabezados
Es una lista no vacía de encabezados de fila o columna de una tabla. Se debe establecer exactamente uno de los siguientes valores: prices
, weights
, num_items
, postal_code_group_names
o location
.
Campos | |
---|---|
prices[] |
Obligatorio. Una lista de los límites superiores de precios de los pedidos inclusivos. El valor del último precio puede ser infinito si se establece price amount_micros = -1. Por ejemplo, |
weights[] |
Obligatorio. Es una lista de límites superiores del peso del pedido inclusivo. El valor del último peso puede ser infinito si se establece price amount_micros = -1. Por ejemplo, |
number_ |
Obligatorio. Es una lista de los límites superiores inclusivos de la cantidad de elementos. El último valor puede ser |
postal_ |
Obligatorio. Es una lista de nombres de grupos postales. El último valor puede ser |
locations[] |
Obligatorio. Es una lista de conjuntos de IDs de ubicación. No debe estar vacío. Solo se puede configurar si no se configuran todos los demás campos. |
Página principal
El mensaje Homepage
representa la página principal de la tienda de un comercio dentro del sistema.
La página principal de un comercio es el dominio principal en el que los clientes interactúan con su tienda.
La página principal se puede reclamar y verificar como prueba de propiedad, y permite que el comercio desbloquee funciones que requieren un sitio web verificado. Para obtener más información, consulta Información sobre la verificación de URLs de tiendas en línea.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la página principal de la tienda. Formato: |
claimed |
Solo salida. Indica si la página principal está reclamada. Consulta https://support.google.com/merchants/answer/176793. |
uri |
Obligatorio. Es el URI (por lo general, una URL) de la página principal de la tienda. |
InsertShippingSettingsRequest
Mensaje de la solicitud para el método InsertShippingSetting
.
Campos | |
---|---|
parent |
Obligatorio. Es la cuenta en la que se insertará este producto. Formato: accounts/{account} |
shipping_ |
Obligatorio. La versión nueva de la cuenta. |
ListAccountIssuesRequest
Mensaje de la solicitud para el método ListAccountIssues
.
Campos | |
---|---|
parent |
Obligatorio. El elemento superior, que es propietario de esta colección de problemas. Formato: |
page_ |
Opcional. Es la cantidad máxima de problemas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 50 usuarios. El valor máximo es 100; los valores superiores a 100 se convertirán a 100. |
page_ |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
language_ |
Opcional. Los problemas de la respuesta tendrán campos legibles por humanos en el idioma determinado. El formato es BCP-47, como |
time_ |
Opcional. La zona horaria de IANA que se usa para localizar las horas en campos legibles por humanos. Por ejemplo, "America/Los_Angeles". Si no se establece, se usará "America/Los_Angeles". |
ListAccountIssuesResponse
Mensaje de respuesta para el método ListAccountIssues
.
Campos | |
---|---|
account_ |
Los problemas de la cuenta especificada. |
next_ |
Un token, que se puede enviar como |
ListAccountsRequest
Mensaje de la solicitud para el método ListAccounts
.
Campos | |
---|---|
page_ |
Opcional. Es la cantidad máxima de cuentas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran como máximo 250 cuentas. El valor máximo es 500, y los valores superiores se convertirán a 500. |
page_ |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
filter |
Opcional. Muestra solo las cuentas que coinciden con el filtro. Para obtener más detalles, consulta la referencia de sintaxis de filtros. |
ListAccountsResponse
Mensaje de respuesta para el método ListAccounts
.
Campos | |
---|---|
accounts[] |
Las cuentas que coinciden con el |
next_ |
Un token, que se puede enviar como |
ListOnlineReturnPoliciesRequest
Mensaje de la solicitud para el método ListOnlineReturnPolicies
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta del comercio para la que se enumerarán las políticas de devoluciones. Formato: |
page_ |
Opcional. Es la cantidad máxima de recursos |
page_ |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListOnlineReturnPoliciesResponse
Mensaje de respuesta para el método ListOnlineReturnPolicies
.
Campos | |
---|---|
online_ |
Las políticas de devoluciones recuperadas |
next_ |
Un token, que se puede enviar como |
ListProgramsRequest
Mensaje de solicitud para el método ListPrograms.
Campos | |
---|---|
parent |
Obligatorio. Es el nombre de la cuenta para la que se recuperarán todos los programas. Formato: |
page_ |
Opcional. Es la cantidad máxima de programas que se mostrarán en una sola respuesta. Si no se especifica (o 0), se usa un tamaño predeterminado de 1,000. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_ |
Opcional. Es un token de Continuation, recibido desde una llamada a |
ListProgramsResponse
Mensaje de respuesta para el método ListPrograms.
Campos | |
---|---|
programs[] |
Los programas de la cuenta determinada. |
next_ |
Es un token que se puede enviar como |
ListRegionsRequest
Mensaje de la solicitud para el método ListRegions
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta para la que se enumerarán las regiones. Formato: |
page_ |
Opcional. Es la cantidad máxima de regiones que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 50 regiones. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_ |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListRegionsResponse
Mensaje de respuesta para el método ListRegions
.
Campos | |
---|---|
regions[] |
Las regiones del comercio especificado. |
next_ |
Un token, que se puede enviar como |
ListSubAccountsRequest
Mensaje de la solicitud para el método ListSubAccounts
.
Campos | |
---|---|
provider |
Obligatorio. El proveedor de servicios de agregación. Formato: |
page_ |
Opcional. Es la cantidad máxima de cuentas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran como máximo 250 cuentas. El valor máximo es 500, y los valores superiores se convertirán a 500. |
page_ |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListSubAccountsResponse
Mensaje de respuesta para el método ListSubAccounts
.
Campos | |
---|---|
accounts[] |
Las cuentas para las que la cuenta parental determinada es un agregador |
next_ |
Un token, que se puede enviar como |
ListUsersRequest
Mensaje de la solicitud para el método ListUsers
.
Campos | |
---|---|
parent |
Obligatorio. El elemento superior, que es propietario de esta colección de usuarios. Formato: |
page_ |
Opcional. Es la cantidad máxima de usuarios que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 50 usuarios. El valor máximo es 100; los valores superiores a 100 se convertirán a 100. |
page_ |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
ListUsersResponse
Mensaje de respuesta para el método ListUsers
.
Campos | |
---|---|
users[] |
Los usuarios de la cuenta especificada. |
next_ |
Un token, que se puede enviar como |
LocationIdSet
Es una lista de conjuntos de IDs de ubicación. No debe estar vacío. Solo se puede configurar si no se configuran todos los demás campos.
Campos | |
---|---|
location_ |
Obligatorio. Es una lista no vacía de IDs de ubicación. Todos deben ser del mismo tipo de ubicación (por ejemplo, estado). |
MinimumOrderValueTable
Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro.
Campos | |
---|---|
store_ |
Obligatorio. Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del pedido (MOV). Se requieren al menos dos conjuntos, y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda. |
StoreCodeSetWithMov
Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del pedido. Se requieren al menos dos conjuntos, y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda.
Campos | |
---|---|
store_ |
Opcional. Es una lista de códigos de tienda únicos o vacía para la opción de todo. |
value |
Es el valor mínimo del pedido para las tiendas determinadas. |
OnlineReturnPolicy
Objeto Online return policy. Actualmente, se usa para representar las políticas de devoluciones de los programas de anuncios y fichas gratuitas.
Campos | |
---|---|
name |
Identificador. |
return_ |
Solo salida. Es el ID de la política de devoluciones que genera Google. |
label |
Obligatorio. Inmutable. Este campo representa la etiqueta única definida por el usuario de la política de devoluciones. Es importante tener en cuenta que no se puede usar la misma etiqueta en diferentes políticas de devoluciones para el mismo país. A menos que un producto especifique un atributo de etiqueta específico, las políticas se etiquetarán automáticamente como "predeterminadas". Para asignar una política de devoluciones personalizada a ciertos grupos de productos, sigue las instrucciones que se proporcionan en la Etiqueta de la política de devoluciones. La etiqueta puede contener hasta 50 caracteres. |
countries[] |
Obligatorio. Inmutable. Los países de venta en los que se aplica la política de devoluciones Los valores deben ser un código ISO 3166 de 2 letras válido. |
policy |
La política de devoluciones. |
seasonal_ |
Opcional. Son anulaciones de la política general para los pedidos realizados durante un conjunto específico de intervalos de tiempo. |
restocking_ |
La tarifa de reposición que se aplica a todas las categorías de motivos de devolución. Si no se establece el valor, se considerará una tarifa de reabastecimiento sin costo. |
return_ |
Son los métodos de devolución que pueden usar los clientes para devolver un artículo. Este valor debe ser no vacío, a menos que el tipo de política de devoluciones sea noReturns. |
item_ |
Las condiciones de los artículos aceptadas para las devoluciones no deben estar vacías, a menos que el tipo de política de devoluciones sea "noReturns". |
return_ |
La tarifa de envío por devolución. Se debe establecer solo cuando el cliente necesita descargar e imprimir la etiqueta de devolución. |
return_ |
Obligatorio. Es el URI de la política de devoluciones. Google puede usar esto para realizar una verificación de la política. Debe ser una URL válida. |
accept_ |
Este campo es obligatorio y especifica si el comercio solo acepta productos defectuosos para las devoluciones. |
process_ |
El campo especifica la cantidad de días que tardan los comercios en procesar los reembolsos. Es opcional. |
accept_ |
Este campo es obligatorio y especifica si el comercio permite que los clientes intercambien productos. |
ItemCondition
Las condiciones disponibles del artículo
Enumeraciones | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
NEW |
Nueva. |
USED |
Usado. |
Política
Las políticas disponibles
Campos | |
---|---|
type |
Tipo de política. |
days |
Es la cantidad de días durante los que se pueden devolver los artículos después de la entrega, donde un día se define como 24 horas después de la marca de tiempo de entrega. Obligatorio para las devoluciones de |
Tipo
Tipos de políticas de devoluciones.
Enumeraciones | |
---|---|
TYPE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
NUMBER_OF_DAYS_AFTER_DELIVERY |
Es la cantidad de días durante los cuales una devolución es válida después de la entrega. |
NO_RETURNS |
No ofrece devoluciones. |
LIFETIME_RETURNS |
Devoluciones ilimitadas. |
RestockingFee
La tarifa de reposición. Puede ser una tarifa fija o un microporcentaje.
Campos | |
---|---|
Campo de unión
|
|
fixed_ |
Tarifa de reposición fija. |
micro_ |
Es el porcentaje del precio total en micros. 15,000,000 significa que se cobraría el 15% del precio total. |
ReturnMethod
Los métodos de devolución disponibles.
Enumeraciones | |
---|---|
RETURN_METHOD_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
BY_MAIL |
Devolución por correo |
IN_STORE |
Devolución en tienda |
AT_A_KIOSK |
Devolución en un kiosco |
ReturnShippingFee
La tarifa de envío por devolución. Puede ser una tarifa fija o un valor booleano para indicar que el cliente paga el costo de envío real.
Campos | |
---|---|
type |
Obligatorio. Es el tipo de tarifa de envío por devolución. |
fixed_ |
Es el importe fijo de la tarifa de envío por devolución. Este valor solo se aplica cuando el tipo es |
Tipo
Tipos de tarifas de envío por devolución.
Enumeraciones | |
---|---|
TYPE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
FIXED |
La tarifa de envío por devolución es un valor fijo. |
CUSTOMER_PAYING_ACTUAL_FEE |
Los clientes pagarán la tarifa real del envío por devolución. |
SeasonalOverride
Siguiente: 5
Campos | |
---|---|
label |
Obligatorio. Es el nombre visible de esta anulación de temporada en Merchant Center. |
begin |
Obligatorio. Define el período en el que se aplica esta excepción de temporada. Tanto el inicio como el final son inclusivos y deben estar en formato decimal de fecha, por ejemplo, 20250115. Las fechas de las excepciones de temporada no deben superponerse. |
end |
Obligatorio. Es la fecha de finalización de la excepción de temporada (inclusive). |
policy |
Obligatorio. Es la política de devoluciones del período determinado. |
PhoneVerificationState
El estado de verificación del teléfono.
Enumeraciones | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
PHONE_VERIFICATION_STATE_VERIFIED |
Se verificó el teléfono. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
El teléfono no está verificado |
Programa
Define la participación en un programa determinado para la cuenta especificada.
Los programas proporcionan un mecanismo para agregar funciones a las cuentas de comerciante. Un ejemplo típico de esto es el programa de fichas de productos gratuitas, que permite que los productos de la tienda de un comercio se muestren en Google de forma gratuita.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso del programa. Formato: |
documentation_ |
Solo salida. Es la URL de una página de ayuda de Merchant Center en la que se describe el programa. |
state |
Solo salida. Es el estado de participación de la cuenta en el programa. |
active_ |
Solo salida. Las regiones en las que la cuenta participa activamente en el programa Las regiones activas se definen como aquellas en las que se cumplen todos los requisitos del programa que las afectan. Los códigos de región se definen en CLDR. Es un país en el que el programa se aplica específicamente o |
unmet_ |
Solo salida. Los requisitos que la cuenta aún no cumple y que afectan la participación en el programa |
Requisito
Define un requisito especificado para participar en el programa.
Campos | |
---|---|
title |
Solo salida. Es el nombre del requisito. |
documentation_ |
Solo salida. Es la URL de una página de ayuda en la que se describe el requisito. |
affected_ |
Solo salida. Las regiones que actualmente se ven afectadas por el incumplimiento de este requisito Los códigos de región se definen en CLDR. Es un país en el que el programa se aplica específicamente o |
Estado
Son los posibles estados de participación en el programa de la cuenta.
Enumeraciones | |
---|---|
STATE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
NOT_ELIGIBLE |
La cuenta no es apta para participar en el programa. |
ELIGIBLE |
La cuenta es apta para participar en el programa. |
ENABLED |
El programa está habilitado para la cuenta. |
RateGroup
Definiciones de grupos de tarifas de envío Solo el último puede tener un applicable_shipping_labels
vacío, lo que significa "todo lo demás". El otro applicable_shipping_labels
no debe superponerse.
Campos | |
---|---|
applicable_ |
Obligatorio. Es una lista de etiquetas de envío que definen los productos a los que se aplica este grupo de tarifas. Esta es una disyunción: solo una de las etiquetas debe coincidir para que se aplique el grupo de tarifas. Solo puede estar vacío para el último grupo de tarifas de un servicio. |
subtables[] |
Opcional. Es una lista de tablas secundarias a las que hace referencia |
carrier_ |
Opcional. Es una lista de tarifas de operadores a las que se puede hacer referencia con |
single_ |
Es el valor del grupo de tarifas (por ejemplo, tarifa plana de USD 10). Solo se puede configurar si no se establecen |
main_ |
Una tabla que define el grupo de tarifas, cuando |
name |
Opcional. Es el nombre del grupo de tarifas. Si se establece, debe ser único dentro del servicio de envío. |
Región
Representa una región geográfica que puedes usar como objetivo con los servicios RegionalInventory
y ShippingSettings
. Puedes definir las regiones como colecciones de códigos postales o, en algunos países, con geosegmentaciones predefinidas. Para obtener más información, consulta Configura regiones .
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la región. Formato: |
postal_ |
Opcional. Es una lista de códigos postales que define el área de la región. |
geotarget_ |
Opcional. Es una lista de geosegmentaciones que define el área de la región. |
regional_ |
Solo salida. Indica si la región es apta para usarse en la configuración del inventario regional. |
shipping_ |
Solo salida. Indica si la región es apta para usarse en la configuración de los servicios de envío. |
display_ |
Opcional. Es el nombre visible de la región. |
GeoTargetArea
Es una lista de geosegmentaciones que define el área de la región.
Campos | |
---|---|
geotarget_ |
Obligatorio. Es una lista no vacía de IDs de ubicación. Todos deben ser del mismo tipo de ubicación (por ejemplo, estado). |
PostalCodeArea
Es una lista de códigos postales que define el área de la región. Nota: Se puede acceder a todas las regiones definidas con códigos postales a través del recurso ShippingSettings.postalCodeGroups
de la cuenta.
Campos | |
---|---|
region_ |
Obligatorio. Es el código de territorio de CLDR o el país al que se aplica el grupo de códigos postales. |
postal_ |
Obligatorio. Es un intervalo de códigos postales. |
PostalCodeRange
Es un rango de códigos postales que define el área de la región.
Campos | |
---|---|
begin |
Obligatorio. Un código postal o un patrón del formato prefijo* que indica el límite inferior inclusivo del rango que define el área. Valores de ejemplo: |
end |
Opcional. Un código postal o un patrón del tipo |
Obligatorio
Describe las condiciones del servicio que se deben aceptar.
Campos | |
---|---|
terms_ |
Los termsOfService que se deben aceptar. |
tos_ |
Es la URL completa del archivo de las Condiciones del Servicio. Este campo es el mismo que TermsOfService.file_uri y se agrega aquí solo por conveniencia. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
Mensaje de la solicitud para el método RetrieveForApplicationTermsOfServiceAgreementState
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta para la que se debe obtener un formato TermsOfServiceAgreementState: |
RetrieveLatestTermsOfServiceRequest
Mensaje de la solicitud para el método RetrieveLatestTermsOfService
.
Campos | |
---|---|
region_ |
Obligatorio. Es el código de región según se define en CLDR. Es un país cuando las Condiciones del Servicio se aplican específicamente a ese país o 001 cuando se aplican a nivel global. |
kind |
Obligatorio. El tipo al que se aplica esta versión de las Condiciones del Servicio. |
Fila
Incluye una lista de celdas.
Campos | |
---|---|
cells[] |
Obligatorio. Es la lista de celdas que conforman la fila. Debe tener la misma longitud que |
Servicio
Servicio de envío
Campos | |
---|---|
delivery_ |
Obligatorio. Es el código de territorio de CLDR de los países a los que se aplica el servicio. |
rate_ |
Opcional. Definiciones de grupos de tarifas de envío Solo el último puede tener un |
loyalty_ |
Opcional. Son los programas de lealtad a los que se limita este servicio de envío. |
service_ |
Obligatorio. Es el nombre del servicio de formato libre. Debe ser único en la cuenta de destino. |
active |
Obligatorio. Es un valor booleano que expone el estado activo del servicio de envío. |
currency_ |
Es el código CLDR de la moneda a la que se aplica este servicio. Debe coincidir con el de los precios de los grupos de tarifas. |
delivery_ |
Obligatorio. Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto. |
shipment_ |
Es el tipo de ubicaciones a las que este servicio envía pedidos. |
minimum_ |
Es el valor mínimo del pedido para este servicio. Si se establece, indica que los clientes deberán gastar, al menos, este importe. Todos los precios de un servicio deben tener la misma moneda. No se puede establecer junto con minimum_order_value_table. |
minimum_ |
Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro. No se puede establecer junto con minimum_order_value. |
store_ |
Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local. |
LoyaltyProgram
Programa de lealtad proporcionado por un comercio.
Campos | |
---|---|
loyalty_ |
Opcional. Es el nivel del programa de lealtad de este servicio de envío. |
program_ |
Es la etiqueta del programa de lealtad establecida en la configuración de tu programa de lealtad en Merchant Center. Este atributo secundario permite que Google asigne tu programa de lealtad a las ofertas aptas. |
LoyaltyProgramTiers
Es un subconjunto de un programa de lealtad de comercios.
Campos | |
---|---|
tier_ |
El atributo secundario etiqueta de nivel [tier_label] diferencia los beneficios del nivel de oferta entre cada nivel. Este valor también se establece en la configuración del programa en Merchant Center y es obligatorio para hacer cambios en la fuente de datos, incluso si tu programa de lealtad solo tiene 1 nivel. |
ShipmentType
Es el tipo de envío del servicio de envío.
Enumeraciones | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Este servicio no especificó el tipo de envío. |
DELIVERY |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. |
LOCAL_DELIVERY |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. El pedido se envía desde una tienda local cercana. |
COLLECTION_POINT |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. El pedido se envía desde un punto de recolección. |
StoreConfig
Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local.
Campos | |
---|---|
store_ |
Opcional. Es una lista de códigos de tienda que proporcionan entrega local. Si está vacío, |
store_ |
Indica si todas las tiendas, o las seleccionadas, que figuran en la ficha de este comercio ofrecen entrega local. |
cutoff_ |
Las configuraciones relacionadas con la entrega local finalizan por el día. |
service_ |
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local. |
CutoffConfig
Las configuraciones relacionadas con la entrega local finalizan por el día.
Campos | |
---|---|
local_ |
Hora en la que finaliza la entrega local del día. |
store_ |
Solo es válido con la entrega local. Representa la hora límite como la cantidad de horas antes del cierre de la tienda. Este campo y |
no_ |
Los comercios pueden inhabilitar la opción de mostrar la entrega local en n+1 días cuando tienen un servicio de envío configurado para la entrega local en n días. Por ejemplo, si el servicio de envío define la entrega el mismo día y ya pasó la hora límite, configurar este campo en |
LocalCutoffTime
Hora en la que finaliza la entrega local del día.
Campos | |
---|---|
hour |
Hora límite para realizar pedidos de entrega local para que se procesen el mismo día. |
minute |
Los pedidos de entrega local en minutos deben realizarse antes de esta hora para que se procesen el mismo día. |
StoreServiceType
Indica si todas las tiendas, o las seleccionadas, que enumera el comercio ofrecen entrega local.
Enumeraciones | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
No se especificó el tipo de servicio de la tienda. |
ALL_STORES |
Indica si todas las tiendas, actuales y futuras, que enumera este comercio ofrecen entrega local. |
SELECTED_STORES |
Indica que solo las tiendas que se indican en store_codes son aptas para la entrega local. |
ShippingSettings
La configuración de envío de la cuenta de comerciante
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la configuración de envío. Formato: |
services[] |
Opcional. La lista de servicios de la cuenta de destino |
warehouses[] |
Opcional. Es una lista de almacenes a los que se puede hacer referencia en |
etag |
Obligatorio. Este campo se usa para evitar problemas asíncronos. Asegúrate de que los datos de configuración de envío no hayan cambiado entre la llamada de Get y la llamada de Insert. El usuario debe seguir los siguientes pasos:
|
Tabla
Una tabla que define el grupo de tarifas, cuando single_value
no es lo suficientemente expresivo.
Campos | |
---|---|
rows[] |
Obligatorio. Es la lista de filas que conforman la tabla. Debe tener la misma longitud que |
name |
Es el nombre de la tabla. Es obligatorio para las tablas secundarias y se ignora para la tabla principal. |
row_ |
Obligatorio. Encabezados de las filas de la tabla. |
column_ |
Encabezados de las columnas de la tabla. Opcional: Si no se establece, la tabla solo tiene una dimensión. |
TermsOfService
El mensaje TermsOfService
representa una versión específica de las condiciones del servicio que los comercios deben aceptar para acceder a ciertas funciones o servicios (consulta https://support.google.com/merchants/answer/160173).
Este mensaje es importante para el proceso de integración, ya que garantiza que los comercios acepten los acuerdos legales necesarios para usar el servicio. Los comercios pueden recuperar las condiciones del servicio más recientes para un kind
y region
determinados a través de RetrieveLatestTermsOfService
y aceptarlas según sea necesario a través de AcceptTermsOfService
.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: |
region_ |
Es el código de región según se define en CLDR. Es un país en el que las Condiciones del Servicio se aplican específicamente a ese país o |
kind |
El tipo al que se aplica esta versión de las Condiciones del Servicio. |
external |
Indica si esta versión de las Condiciones del Servicio es externa. Las versiones externas de las Condiciones del Servicio solo se pueden acordar a través de procesos externos y no directamente por parte del comercio a través de la IU o la API. |
file_ |
Es el URI del archivo de condiciones del servicio que se debe mostrar a los usuarios que firman. |
TermsOfServiceAgreementState
Este recurso representa el estado del acuerdo de una cuenta y un tipo de condiciones del servicio determinados. El estado es el siguiente:
- Si el comercio aceptó las condiciones del servicio, se propagará accepted; de lo contrario, estará vacío.
- Si el comercio debe firmar las condiciones del servicio, se propagará obligatorio; de lo contrario, estará vacío.
Ten en cuenta que pueden estar presentes los valores required y accepted. En este caso, las condiciones del servicio de accepted
tendrán una fecha de vencimiento establecida en el campo valid_until. Las condiciones del servicio de required
deben aceptarse antes de valid_until
para que la cuenta siga teniendo un acuerdo válido. Cuando se aceptan nuevas condiciones del servicio, esperamos que los terceros muestren el texto asociado con el acuerdo de condiciones del servicio determinado (la URL del archivo que contiene el texto se agrega en el mensaje obligatorio que aparece a continuación como tos_file_uri). Para aceptar las condiciones del servicio, llama a accept en el recurso TermsOfService.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: |
region_ |
Código de región según se define en https://cldr.unicode.org/. Es el país al que se aplica el estado actual. |
terms_ |
Es el tipo de Condiciones del Servicio asociadas con la versión en particular. |
accepted |
Las condiciones del servicio aceptadas de este tipo y para el region_code asociado |
required |
Las Condiciones del Servicio requeridas |
TermsOfServiceKind
El tipo TermsOfService.
Enumeraciones | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
MERCHANT_CENTER |
Aplicación de Merchant Center. |
TransitTable
Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de filas y columnas Se puede configurar min_transit_days
, max_transit_days
o transit_time_table
, pero no ambos.
Campos | |
---|---|
postal_ |
Obligatorio. Es una lista de nombres de regiones |
transit_ |
Obligatorio. Es una lista de etiquetas de tiempo en tránsito. El último valor puede ser |
rows[] |
Obligatorio. Si solo hay un conjunto de dimensiones de |
TransitTimeRow
Si solo hay un conjunto de dimensiones de postal_code_group_names
o transit_time_labels
, hay varias filas, cada una con un valor para esa dimensión. Si hay dos dimensiones, cada fila corresponde a un postal_code_group_names
y las columnas (valores) a un transit_time_labels
.
Campos | |
---|---|
values[] |
Obligatorio. Es el intervalo de tiempo en tránsito (mínimo y máximo) en días hábiles. |
TransitTimeValue
Es el intervalo de tiempo en tránsito (mínimo-máximo) en días hábiles.
Campos | |
---|---|
min_ |
Es el intervalo mínimo del tiempo en tránsito en días hábiles. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. |
max_ |
Debe ser mayor o igual que |
UnclaimHomepageRequest
Mensaje de la solicitud para el método UnclaimHomepage
.
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la página principal que se dejará de reclamar. Formato: |
UpdateAccountRequest
Mensaje de la solicitud para el método UpdateAccount
.
Campos | |
---|---|
account |
Obligatorio. La versión nueva de la cuenta. |
update_ |
Opcional. Es la lista de campos que se actualizarán. Se admiten los siguientes campos (en
|
UpdateAutofeedSettingsRequest
Mensaje de la solicitud para el método UpdateAutofeedSettings
.
Campos | |
---|---|
autofeed_ |
Obligatorio. La nueva versión de la configuración del feed automático |
update_ |
Obligatorio. Es la lista de campos que se actualizarán. |
UpdateBusinessIdentityRequest
Mensaje de la solicitud para el método UpdateBusinessIdentity
.
Campos | |
---|---|
business_ |
Obligatorio. Es la nueva versión de la identidad de la empresa. |
update_ |
Opcional. Es la lista de campos que se actualizarán. Se admiten los siguientes campos (en
|
UpdateBusinessInfoRequest
Mensaje de la solicitud para el método UpdateBusinessInfo
.
Campos | |
---|---|
business_ |
Obligatorio. La nueva versión de la información de la empresa. |
update_ |
Opcional. Es la lista de campos que se actualizarán. Se admiten los siguientes campos (en
|
UpdateEmailPreferencesRequest
Mensaje de solicitud para el método UpdateEmailPreferences.
Campos | |
---|---|
email_ |
Obligatorio. Se actualizarán las preferencias de correo electrónico. |
update_ |
Obligatorio. Es la lista de campos que se actualizarán. Se admiten los siguientes campos (en
|
UpdateHomepageRequest
Mensaje de la solicitud para el método UpdateHomepage
.
Campos | |
---|---|
homepage |
Obligatorio. La nueva versión de la página principal. |
update_ |
Opcional. Es la lista de campos que se actualizarán. Se admiten los siguientes campos (en
|
UpdateRegionRequest
Mensaje de la solicitud para el método UpdateRegion
.
Campos | |
---|---|
region |
Obligatorio. La región actualizada. |
update_ |
Opcional. Es la máscara de campo separada por comas que indica los campos que se actualizarán. Ejemplo: |
UpdateUserRequest
Mensaje de la solicitud para el método UpdateUser
.
Campos | |
---|---|
user |
Obligatorio. Es la versión nueva del usuario. Usa |
update_ |
Opcional. Es la lista de campos que se actualizarán. Se admiten los siguientes campos (en
|
Usuario
El mensaje User
representa a un usuario asociado con una cuenta de Merchant Center. Se usa para administrar los permisos de usuario y los derechos de acceso dentro de la cuenta. Para obtener más información, consulta las Preguntas frecuentes sobre las personas y los niveles de acceso.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso del usuario. Formato: Usa |
state |
Solo salida. Es el estado del usuario. |
access_ |
Opcional. Los derechos de acceso que tiene el usuario. |
Estado
Son los estados posibles de un usuario.
Enumeraciones | |
---|---|
STATE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
PENDING |
El usuario está pendiente de confirmación. En este estado, el usuario primero debe aceptar la invitación antes de realizar otras acciones. |
VERIFIED |
Se verificó al usuario. |
Valor
Es el valor único de un grupo de tarifas o el valor de la celda de una tabla de grupos de tarifas. Se debe establecer exactamente uno de los siguientes valores: no_shipping
, flat_rate
, price_percentage
, carrier_rateName
, subtable_name
.
Campos | |
---|---|
no_ |
Si es verdadero, el producto no se puede enviar. Debe ser verdadero cuando se establece y solo se puede establecer si no se establecieron todos los demás campos. |
flat_ |
Una tarifa plana. Solo se puede configurar si no se configuran todos los demás campos. |
price_ |
Es un porcentaje del precio representado como un número en notación decimal (por ejemplo, |
carrier_ |
Es el nombre de una tarifa de la empresa de transporte que hace referencia a una tarifa de la empresa de transporte definida en el mismo grupo de tarifas. Solo se puede configurar si no se configuran todos los demás campos. |
subtable |
Es el nombre de una tabla secundaria. Solo se puede establecer en celdas de tabla (por ejemplo, no para valores individuales) y solo si no se configuran todos los demás campos. |
Almacén
Un almacén de distribución, que almacena y controla el inventario.
Campos | |
---|---|
name |
Obligatorio. El nombre del almacén Debe ser único en la cuenta. |
shipping_ |
Obligatorio. Es la dirección de envío del almacén. |
cutoff_ |
Obligatorio. Es la hora del día más tarde a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén. |
handling_ |
Obligatorio. Es la cantidad de días que tarda este almacén en empacar y enviar un artículo. Esto se aplica a nivel del almacén, pero se puede anular a nivel de la oferta según los atributos de un artículo. |
business_ |
Son los días hábiles del almacén. Si no se establece, será de lunes a viernes de forma predeterminada. |
WarehouseBasedDeliveryTime
Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se establece, no se debe establecer ningún otro campo relacionado con el tiempo de tránsito en delivery_time
.
Campos | |
---|---|
carrier |
Obligatorio. Operador, como |
carrier_ |
Obligatorio. Servicio de operador, como |
warehouse |
Obligatorio. Es el nombre del almacén. Debe coincidir con [warehouse][ShippingSetting.warehouses.name] |
WarehouseCutoffTime
Es la hora del día más tarde a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén.
Campos | |
---|---|
hour |
Obligatorio. Es la hora del horario límite hasta la que se debe realizar un pedido para que el almacén lo procese el mismo día. La hora se basa en la zona horaria del almacén. |
minute |
Obligatorio. Es el minuto del horario límite hasta el que se debe realizar un pedido para que el almacén lo procese el mismo día. El minuto se basa en la zona horaria del almacén. |