Índice
AccountIssueService
(interfaz)AccountsService
(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)AccountIssue
(mensaje)AccountIssue.ImpactedDestination
(mensaje)AccountIssue.ImpactedDestination.Impact
(mensaje)AccountIssue.Severity
(enumeración)Address
(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.AcceptTermsOfService
(mensaje)CreateAndConfigureAccountRequest.AddAccountService
(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)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)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)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 compatible con la API de AccountIssueService
.
ListAccountIssues |
---|
Muestra una lista de todos los problemas de una cuenta de Merchant Center.
|
AccountsService
Servicio compatible con 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. Ejecutar este método requiere acceso de administrador.
|
GetAccount |
---|
Recupera una cuenta de Merchant Center. Después de insertar, actualizar o borrar una cuenta, es posible que los cambios tarden varios minutos en aplicarse.
|
ListAccounts |
---|
Muestra una lista de las cuentas a las que puede acceder el usuario que emite la llamada y que coinciden con las restricciones de la solicitud, como el tamaño de la página o los filtros. Esto no es solo enumerar las cuentas secundarias de una MCA, sino que todas las cuentas a las que el usuario que realiza la llamada tiene acceso, incluidas otras MCA, cuentas vinculadas, cuentas independientes, etcétera.
|
ListSubAccounts |
---|
Enumera todas las cuentas secundarias de una cuenta de varios clientes determinada. Es un wrapper práctico para el método
|
UpdateAccount |
---|
Actualiza una cuenta independientemente de su tipo: independiente, MCA o cuenta secundaria. Ejecutar este método requiere acceso de administrador.
|
BusinessIdentityService
Servicio compatible con la API de Business Identity
GetBusinessIdentity |
---|
Recupera la identidad de empresa de una cuenta.
|
UpdateBusinessIdentity |
---|
Actualiza la identidad de la empresa de una cuenta. Ejecutar este método requiere acceso de administrador.
|
BusinessInfoService
Servicio compatible con la API de Business Info.
GetBusinessInfo |
---|
Recupera la información de la empresa de una cuenta.
|
UpdateBusinessInfo |
---|
Actualiza la información de la empresa de una cuenta. Ejecutar este método requiere acceso de administrador.
|
EmailPreferencesService
Servicio compatible con la API de EmailPreferences
.
Este servicio solo permite recuperar y actualizar las preferencias de correo electrónico del usuario autenticado.
GetEmailPreferences |
---|
Muestra las preferencias de correo electrónico de un usuario de la cuenta de Merchant Center. 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 la cuenta de Merchant Center. Los usuarios de la MCA deben especificar la cuenta de la MCA en lugar de una cuenta secundaria. No se actualizarán las preferencias que no se seleccionen explícitamente en la máscara de actualización. No es válido para 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 compatible con una API para la página principal de una tienda.
ClaimHomepage |
---|
Reclama la página principal de una tienda. Ejecutar este método requiere acceso de administrador. Si ya se reclamó la página principal, se volverá a verificar la verificación (a menos que el comercio esté exento de reclamos, lo cual también exime a este tipo de verificación) y se devolverá una respuesta exitosa. 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: user no tiene los permisos necesarios en esta cuenta de MC. * FAILED_PRECONDITION: - La cuenta no es de Merchant Center. - La cuenta de MC no tiene una página principal. - error de reclamo (en este caso, el mensaje de error contendrá más información)
|
GetHomepage |
---|
Recupera la página principal de una tienda.
|
UnclaimHomepage |
---|
Anula el reclamo de la página principal de una tienda. Ejecutar este método requiere acceso de administrador.
|
UpdateHomepage |
---|
Actualiza la página principal de una tienda. Ejecutar este método requiere acceso de administrador.
|
OnlineReturnPolicyService
El servicio facilita la administración de la configuración de la política de devoluciones por arrepentimiento del comercio, lo que incluye 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.
|
ListOnlineReturnPolicies |
---|
Enumera todas las políticas de devoluciones existentes.
|
ProgramsService
Servicio de gestión de programas.
Los programas ofrecen un mecanismo para agregar funciones a las cuentas de comerciante. Un ejemplo típico de esto es el programa Fichas de producto gratuitas, que permite que los productos de la tienda de un comercio se muestren en Google de forma gratuita.
Este servicio ofrece métodos para recuperar la participación de un comerciante en todos los programas disponibles, además de métodos para habilitar o inhabilitar explícitamente la participación en cada programa.
DisableProgram |
---|
Inhabilitar la participación en el programa especificado para la cuenta. Ejecutar este método requiere acceso de administrador.
|
EnableProgram |
---|
Habilitar la participación en el programa especificado para la cuenta. Ejecutar este método 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. Ejecutar este método requiere acceso de administrador.
|
DeleteRegion |
---|
Borra una definición de región de tu cuenta de Merchant Center. Ejecutar este método requiere acceso de administrador.
|
GetRegion |
---|
Recupera una región definida en su cuenta de Merchant Center.
|
ListRegions |
---|
Muestra una lista de las regiones en tu cuenta de Merchant Center.
|
UpdateRegion |
---|
Actualiza una definición de región en tu cuenta de Merchant Center. Ejecutar este método requiere acceso de administrador.
|
ShippingSettingsService
Es un servicio para obtener información de la configuración de envío de llamadas a métodos según el método de la API de Merchant Center.
GetShippingSettings |
---|
Recupera la información de configuración de envío.
|
InsertShippingSettings |
---|
Reemplaza la configuración de envío de un comercio con la configuración de envío de la solicitud. Ejecutar este método requiere acceso de administrador.
|
TermsOfServiceAgreementStateService
Servicio compatible con la API de TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Muestra el estado del acuerdo de las Condiciones del Servicio.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
Recupera el estado del acuerdo de las condiciones del servicio de la aplicación.
|
TermsOfServiceService
Servicio compatible con la API de TermsOfService
.
AcceptTermsOfService |
---|
Acepta un
|
GetTermsOfService |
---|
Recupera el
|
RetrieveLatestTermsOfService |
---|
Recupera la versión más reciente del
|
UserService
Servicio compatible con la API de usuario.
CreateUser |
---|
Crea un usuario de cuenta de Merchant Center. Ejecutar este método requiere acceso de administrador.
|
DeleteUser |
---|
Borra un usuario de la cuenta de Merchant Center. Ejecutar este método requiere acceso de administrador.
|
GetUser |
---|
Recupera un usuario de cuenta de Merchant Center.
|
ListUsers |
---|
Muestra una lista de todos los usuarios de una cuenta de Merchant Center.
|
UpdateUser |
---|
Actualiza a un usuario de la cuenta de Merchant Center. Ejecutar este método requiere acceso de administrador.
|
AcceptTermsOfServiceRequest
Mensaje de la solicitud para el método AcceptTermsOfService
.
Campos | |
---|---|
name |
Obligatorio. El nombre del recurso de la versión de las Condiciones del Servicio. Formato: |
account |
Obligatorio. Es la cuenta en la que se deben aceptar las Condiciones del Servicio. |
region_code |
Obligatorio. Código regional como lo define CLDR. Esto puede ser un país en el que las Condiciones del Servicio se aplican específicamente a ese país o el 001, cuando se aplican a nivel mundial. |
Aceptado
Describe las Condiciones del Servicio aceptadas.
Campos | |
---|---|
terms_of_service |
Las termsOfService aceptadas. |
accepted_by |
La cuenta donde se registró la aceptación. Puede ser la propia cuenta o, en el caso de las cuentas secundarias, la cuenta de la MCA. |
valid_until |
Cuando se establece, indica que las TermsOfService aceptadas solo son válidas hasta el final de esta fecha (en UTC). Debes aceptar uno nuevo antes de esa fecha. La información de las TermsOfService obligatorias se encuentra en el mensaje Obligatorio. |
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 que tienen este derecho tienen acceso al rendimiento y las estadísticas. |
Cuenta
Una cuenta
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la cuenta. Formato: |
account_id |
Solo salida. Es el ID de la cuenta. |
account_name |
Obligatorio. Es un nombre de la cuenta en lenguaje natural. Consulta el nombre de la tienda y el nombre de la empresa para obtener más información. |
adult_content |
Si esta cuenta incluye contenido para adultos |
test_account |
Solo salida. Si se trata de una cuenta de prueba |
time_zone |
Obligatorio. La zona horaria de la cuenta. En las operaciones de escritura, Para las lecturas, |
language_code |
Obligatorio. El código de idioma BCP-47 de la cuenta, como |
AccountIssue
Un objeto AccountIssue
Campos | |
---|---|
name |
Identificador. 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_destinations[] |
El impacto que este problema tiene en varios destinos. |
detail |
Detalles localizados adicionales sobre el problema |
documentation_uri |
Vínculo al Centro de ayuda de Merchant Center para proporcionar más información sobre el problema y cómo solucionarlo. |
ImpactedDestination
Indica el impacto del problema en un destino.
Campos | |
---|---|
impacts[] |
El impacto (negativo) de varias regiones en el destino determinado. |
reporting_context |
El contexto de los informes afectados. |
Impacto
El impacto del problema en una región.
Campos | |
---|---|
region_code |
Es el código regional de CLDR donde se aplica este problema. |
severity |
Indica la gravedad del problema en el destino y la región. |
Gravedad
Toda la gravedad posible del problema.
Enumeraciones | |
---|---|
SEVERITY_UNSPECIFIED |
La gravedad es desconocida. |
CRITICAL |
El problema hace que las ofertas no se publiquen. |
ERROR |
Es posible que el problema afecte a las ofertas (en el futuro) o sea un indicador de problemas con ellas. |
SUGGESTION |
El problema es una sugerencia de mejora. |
Dirección
Dirección de envío del almacén.
Campos | |
---|---|
street_address |
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_area |
Obligatorio. Subdivisión administrativa de nivel superior del país. Por ejemplo, puede ser un estado como California ("CA") o una provincia como Quebec ("QC"). |
postal_code |
Obligatorio. Es el código postal (por ejemplo, “94043”). |
region_code |
Obligatorio. Código de país de CLDR (por ejemplo, “US”). |
BusinessDayConfig
Días hábiles del depósito
Campos | |
---|---|
business_days[] |
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. El nombre del recurso de la identidad de la empresa. Formato: |
promotions_consent |
Opcional. Si los atributos de identidad se pueden usar para promociones. |
black_owned |
Opcional. Especifica si la empresa se identifica como de negros. Este campo opcional solo estará disponible para los comercios cuyo país de la empresa se haya establecido en |
women_owned |
Opcional. Especifica si la empresa se identifica como una empresa de mujeres. Este campo opcional solo estará disponible para los comercios cuyo país de la empresa se haya establecido en |
veteran_owned |
Opcional. Especifica si la empresa se identifica como empresa propiedad de los veteranos. Este campo opcional solo estará disponible para los comercios cuyo país de la empresa se haya establecido en |
latino_owned |
Opcional. Especifica si la empresa se identifica como propietaria de una comunidad latina. Este campo opcional solo estará disponible para los comercios cuyo país de la empresa se haya establecido en |
small_business |
Opcional. Especifica si la empresa se identifica como pequeña. Este campo opcional solo estará disponible para los comercios cuyo país de la empresa esté configurado en |
IdentityAttribute
Toda la información relacionada con un atributo de identidad.
Campos | |
---|---|
identity_declaration |
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 |
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 relacionadas con la identidad de la empresa.
Enumeraciones | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
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 la identidad de su empresa para las promociones. |
PROMOTIONS_CONSENT_DENIED |
Indica que la cuenta no dio su consentimiento para que se usara la identidad de su empresa para las promociones. |
BusinessInfo
Recopilación de información relacionada con una empresa.
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la información de la empresa. Formato: |
address |
Opcional. Es la dirección de la empresa. |
phone |
Solo salida. Es el número de teléfono de la empresa. |
phone_verification_state |
Solo salida. Es el estado de la verificación telefónica de la empresa. |
customer_service |
Opcional. Es la atención al cliente de la empresa. |
korean_business_registration_number |
Opcional. El número de registro comercial de Corea de 10 dígitos, separado por guiones, en el formato XXX-XX-XXXXX. |
CarrierRate
Es una lista de las tarifas de la empresa de transporte a las que se puede hacer referencia mediante main_table
o single_value
.
Campos | |
---|---|
name |
Obligatorio. Indica el nombre de la tarifa de la empresa de transporte. Debe ser único por grupo de tarifas. |
carrier |
Obligatorio. Servicio del operador, como |
carrier_service |
Obligatorio. Servicio del operador, como |
origin_postal_code |
Obligatorio. Origen de envío para esta tarifa de empresa de transporte. |
percentage_adjustment |
Opcional. Modificador de tarifa de envío multiplicativa como un número en notación decimal. Puede ser negativo. Por ejemplo, |
flat_adjustment |
Opcional. Modificador aditivo de tarifa de envío. Puede ser negativo. Por ejemplo, |
ClaimHomepageRequest
Mensaje de la solicitud para el método ClaimHomepage
.
Campos | |
---|---|
name |
Obligatorio. El nombre de la página principal que se reclamará. Formato: |
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. |
service[] |
Obligatorio. Se inicializa un servicio de cuentas entre la cuenta que se creará y la cuenta de proveedor como parte de la creación. Se debe proporcionar al menos uno de esos servicios. Actualmente, solo se admite |
accept_terms_of_service |
Opcional. Las Condiciones del Servicio se deben aceptar inmediatamente después de crear la cuenta. |
AcceptTermsOfService
Referencia a un recurso de las Condiciones del Servicio.
Campos | |
---|---|
name |
Obligatorio. El nombre del recurso de la versión de las Condiciones del Servicio. |
region_code |
Obligatorio. Código regional como lo define CLDR. Esto puede ser un país en el que las Condiciones del Servicio se aplican específicamente a ese país o |
AddAccountService
Instrucciones adicionales para agregar servicios de la cuenta durante su creación.
Campos | |
---|---|
Campo de unión service_type . Actualmente, solo se admite el tipo de cuenta principal de varios clientes. service_type puede ser solo uno de los siguientes: |
|
account_aggregation |
El proveedor es un agregador de la cuenta. |
provider |
Opcional. Es el proveedor del servicio. Formato: |
CreateRegionRequest
Mensaje de la solicitud para el método CreateRegion
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta para la que se crea una región. Formato: |
region_id |
Obligatorio. El identificador de la región, único para 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. El nombre del recurso de la cuenta para la que se creará un usuario. Formato: |
user_id |
Obligatorio. Es la dirección de correo electrónico del usuario (por ejemplo, |
user |
Obligatorio. El usuario que se creará. |
CustomerService
Información de atención al cliente.
Campos | |
---|---|
uri |
Opcional. El URI en el que se puede encontrar el servicio de atención al cliente. |
email |
Opcional. Es la dirección de correo electrónico a la que se puede contactar con el servicio de atención al cliente. |
phone |
Opcional. El número de teléfono al que se puede llamar el servicio de atención al cliente. |
CutoffTime
Definición de la hora límite de los días hábiles.
Campos | |
---|---|
hour |
Obligatorio. Es la hora límite hasta la que se debe realizar un pedido para que se procese el mismo día. |
minute |
Obligatorio. Minuto del horario límite hasta el que se debe realizar un pedido para que se procese el mismo día. |
time_zone |
Obligatorio. Identificador de la zona horaria Por ejemplo, "Europa/Zúrich". |
DeleteAccountRequest
Mensaje de la solicitud para el método DeleteAccount
.
Campos | |
---|---|
name |
Obligatorio. El nombre de la cuenta que se borrará. Formato: |
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. El nombre del usuario que se borrará. Formato: También es posible borrar el usuario correspondiente al emisor si usas |
DeliveryTime
Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.
Campos | |
---|---|
warehouse_based_delivery_times[] |
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 configura, no se debe establecer ningún otro campo relacionado con el tiempo en tránsito en [tiempo de entrega][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min_transit_days |
Es la cantidad mínima de días hábiles en tránsito. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. Se debe configurar |
max_transit_days |
Es la cantidad máxima de días hábiles que se pasan en tránsito. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. Debe ser mayor o igual que |
cutoff_time |
Definición de la hora límite de los días hábiles. Si no se configura, se establecerá la hora límite de forma predeterminada a las 8 a.m. PST. |
min_handling_days |
Indica la cantidad mínima de días hábiles invertidos antes de que se envíe un pedido. 0 significa envío el mismo día, 1 significa envío al día siguiente. |
max_handling_days |
Es la cantidad máxima de días hábiles invertidos antes de que se envíe un pedido. 0 significa envío el mismo día, 1 significa envío al día siguiente. Debe ser mayor o igual que |
transit_time_table |
Tabla de tiempo en tránsito, que corresponde a la cantidad de días hábiles que se pasaron en tránsito según las dimensiones de filas y columnas. Se puede configurar |
handling_business_day_config |
Los días hábiles durante los cuales se pueden procesar los pedidos. Si no se proporciona, se asumirán los días hábiles de lunes a viernes. |
transit_business_day_config |
Son los días hábiles durante los cuales los pedidos pueden estar en tránsito. Si no se proporciona, se asumirán los días hábiles de lunes a viernes. |
DisableProgramRequest
Mensaje de solicitud para el métodoDisableProgram.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del programa para el que se inhabilita la participación para la cuenta determinada. Formato: |
Distancia
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío con entrega local.
Campos | |
---|---|
value |
Valor entero de la distancia. |
unit |
La unidad puede variar según el país, se parametriza para incluir millas y kilómetros. |
Unidad
La unidad puede variar según el país, se parametriza para incluir millas y kilómetros.
Enumeraciones | |
---|---|
UNIT_UNSPECIFIED |
Unidad sin especificar |
MILES |
Unidad en millas |
KILOMETERS |
Unidad en kilómetros |
EmailPreferences
Son 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_and_tips |
Opcional. Actualizaciones sobre funciones nuevas, sugerencias y prácticas recomendadas. |
OptInState
Habilita el estado de la preferencia de correo electrónico.
Enumeraciones | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
No se especificó el estado de la habilitación. |
OPTED_OUT |
El usuario rechazó la recepción de este tipo de correos electrónicos. |
OPTED_IN |
El usuario aceptó recibir este tipo de correo electrónico. |
UNCONFIRMED |
El usuario aceptó recibir este tipo de correo electrónico y el correo electrónico de confirmación se envió, pero aún no ha confirmado la aceptación (solo se aplica a determinados países). |
EnableProgramRequest
Mensaje de solicitud para el método EnableProgram.
Campos | |
---|---|
name |
Obligatorio. Es el nombre del programa para el que se habilita la participación para la cuenta determinada. Formato: |
GetAccountRequest
Mensaje de la solicitud para el método GetAccount
.
Campos | |
---|---|
name |
Obligatorio. El nombre de la cuenta que se recuperará. Formato: |
GetBusinessIdentityRequest
Mensaje de la solicitud para el método GetBusinessIdentity
.
Campos | |
---|---|
name |
Obligatorio. El nombre del recurso de la identidad de la empresa. Formato: |
GetBusinessInfoRequest
Mensaje de la solicitud para el método GetBusinessInfo
.
Campos | |
---|---|
name |
Obligatorio. 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. El nombre de la página de inicio que se recuperará. Formato: |
GetOnlineReturnPolicyRequest
Mensaje de la solicitud para el método GetOnlineReturnPolicy
.
Campos | |
---|---|
name |
Obligatorio. 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. 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. 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. 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. El nombre del usuario que se recuperará. Formato: También es posible recuperar el usuario correspondiente al emisor si se usa |
Encabezados
Una lista no vacía de encabezados de filas o columnas 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 del precio del pedido inclusivo. Si estableces price amount_micros = -1, el valor del último precio puede ser infinito. Por ejemplo, |
weights[] |
Obligatorio. Una lista de los límites superiores del peso de orden inclusivo. El último valor de la ponderación puede ser infinito si se establece price_micros = -1. Por ejemplo, |
number_of_items[] |
Obligatorio. Una lista de los límites superiores de la cantidad inclusiva de elementos. El último valor puede ser |
postal_code_group_names[] |
Obligatorio. Es una lista de nombres de grupos postales. El último valor puede ser |
locations[] |
Obligatorio. Es una lista de conjuntos de ID de ubicación. No puede estar vacío. Solo se puede establecer si no están configurados todos los demás campos. |
Página principal
Es la página principal de una tienda.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso de la página principal de la tienda. Formato: |
claimed |
Solo salida. Si se reclama la página principal. Consulte 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. La cuenta en la que se insertará este producto. Formato: cuentas/{account} |
shipping_setting |
Obligatorio. La nueva versión de la cuenta. |
ListAccountIssuesRequest
Mensaje de la solicitud para el método ListAccountIssues
.
Campos | |
---|---|
parent |
Obligatorio. La entidad superior, propietaria de esta colección de ediciones. Formato: |
page_size |
Opcional. La cantidad máxima de ediciones que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán 50 usuarios como máximo. El valor máximo es 100. los valores superiores a 100 se convertirán en 100 |
page_token |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
language_code |
Opcional. Los problemas de la respuesta tendrán campos legibles por humanos en el idioma determinado. El formato es BCP-47, como |
time_zone |
Opcional. La zona horaria IANA que se usa para localizar horas en campos legibles por humanos. Por ejemplo, “America/Los_Angeles”. Si no se establece, “America/Los_Angeles” que se usará. |
ListAccountIssuesResponse
Mensaje de respuesta para el método ListAccountIssues
.
Campos | |
---|---|
account_issues[] |
Son los problemas de la cuenta especificada. |
next_page_token |
Un token, que se puede enviar como |
ListAccountsRequest
Mensaje de la solicitud para el método ListAccounts
.
Campos | |
---|---|
page_size |
Opcional. La cantidad máxima de cuentas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran 250 cuentas como máximo. El valor máximo es 500. los valores superiores a 500 se convierten a 500. |
page_token |
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 |
next_page_token |
Un token, que se puede enviar como |
ListOnlineReturnPoliciesRequest
Mensaje de la solicitud para el método ListOnlineReturnPolicies
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta del comerciante para la que se enumeran las políticas de devoluciones. Formato: |
page_size |
Opcional. La cantidad máxima de recursos |
page_token |
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_return_policies[] |
Las políticas de devoluciones recuperadas. |
next_page_token |
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_size |
Opcional. La cantidad máxima de programas que se mostrarán en una sola respuesta. Si no se especifica (o es 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_token |
Opcional. Un token de continuación, recibido de una llamada |
ListProgramsResponse
Mensaje de respuesta para el método ListPrograms.
Campos | |
---|---|
programs[] |
Son los programas de la cuenta determinada. |
next_page_token |
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 enumeran las regiones. Formato: |
page_size |
Opcional. 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 50 regiones como máximo. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. |
page_token |
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[] |
Son las regiones del comercio especificado. |
next_page_token |
Un token, que se puede enviar como |
ListSubAccountsRequest
Mensaje de la solicitud para el método ListSubAccounts
.
Campos | |
---|---|
provider |
Obligatorio. La cuenta principal Formato: |
page_size |
Opcional. La cantidad máxima de cuentas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran 250 cuentas como máximo. El valor máximo es 500. los valores superiores a 500 se convierten a 500. |
page_token |
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 en las que la cuenta principal especificada es un agregador. |
next_page_token |
Un token, que se puede enviar como |
ListUsersRequest
Mensaje de la solicitud para el método ListUsers
.
Campos | |
---|---|
parent |
Obligatorio. El elemento superior, propietario de esta colección de usuarios. Formato: |
page_size |
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 50 usuarios como máximo. El valor máximo es 100. los valores superiores a 100 se convertirán en 100 |
page_token |
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[] |
Son los usuarios de la cuenta especificada. |
next_page_token |
Un token, que se puede enviar como |
LocationIdSet
Es una lista de conjuntos de ID de ubicación. No puede estar vacío. Solo se puede establecer si no están configurados todos los demás campos.
Campos | |
---|---|
location_ids[] |
Obligatorio. Una lista no vacía de IDs de ubicación. Todas deben ser del mismo tipo de ubicación (por ejemplo, estado). |
MinimumOrderValueTable
Tabla de los valores de pedido mínimos por tienda para el tipo de entrega de retiro.
Campos | |
---|---|
store_code_set_with_movs[] |
Obligatorio. Una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de 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
Una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de 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_codes[] |
Opcional. Una lista de códigos de tienda únicos o vacía para la genérica. |
value |
Es el valor mínimo de pedido para las tiendas determinadas. |
OnlineReturnPolicy
Política de devoluciones en línea. Actualmente, se usa para representar las políticas de devoluciones de anuncios y programas de fichas gratuitas.
Campos | |
---|---|
name |
Identificador. |
return_policy_id |
Solo salida. Es el ID de la política de devoluciones que genera Google. |
label |
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 indican en la Etiqueta de la política de devoluciones. La etiqueta puede contener hasta 50 caracteres. |
countries[] |
Los países de venta en los que se aplica la política de devoluciones. Los valores deben ser un código ISO 3166 válido de 2 letras. |
policy |
Es la política de devoluciones. |
restocking_fee |
Es la tarifa de reposición que se aplica a todas las categorías de motivos de devolución. Esto se consideraría una tarifa de reposición gratuita si no se establece el valor. |
return_methods[] |
Son los métodos de devolución que indican los clientes que pueden devolver un artículo. Se requiere que este valor no esté vacío, a menos que el tipo de política de devoluciones sea noReturns. |
item_conditions[] |
Las condiciones de los artículos que se aceptan para las devoluciones no deben estar vacías, a menos que el tipo de política de devoluciones sea “noReturns”. |
return_shipping_fee |
Es la tarifa de envío por devolución. Se debe configurar solo cuando el cliente necesita descargar e imprimir la etiqueta de devolución. |
return_policy_uri |
Es el URI de la política de devoluciones. Google puede usar esta información para realizar una verificación de estado de la política. Debe ser una URL válida. |
accept_defective_only |
Este campo es obligatorio y especifica si el comercio solo acepta productos defectuosos para devoluciones. |
process_refund_days |
Este campo especifica la cantidad de días que tardan los comercios en procesar reembolsos y es opcional. |
accept_exchange |
Este campo especifica si el comercio permite que los clientes intercambien productos; este campo es obligatorio. |
ItemCondition
Son 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 |
La cantidad de días en los que se pueden devolver los artículos después de la entrega. Un día se define como 24 horas después de la marca de tiempo de la entrega. Obligatorio para las devoluciones de |
Tipo
Tipos de política de devoluciones.
Enumeraciones | |
---|---|
TYPE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
NUMBER_OF_DAYS_AFTER_DELIVERY |
Es la cantidad de días en los que una devolución es válida después de la entrega. |
NO_RETURNS |
No ofrece devoluciones. |
LIFETIME_RETURNS |
El tiempo regresa. |
RestockingFee
Es la tarifa de reposición. Puede ser una tarifa fija o un microporcentaje.
Campos | |
---|---|
Campo de unión
|
|
fixed_fee |
Tarifa de reposición fija. |
micro_percent |
Porcentaje del precio total en micros. 15,000,000 significa que se cobrará 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 postal. |
IN_STORE |
Devolución en tienda. |
AT_A_KIOSK |
Regresa al kiosco. |
ReturnShippingFee
Es 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 |
Es el tipo de tarifa de envío por devolución. |
fixed_fee |
Importe fijo de la tarifa de envío por devolución. Este valor solo es aplicable 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 tiene un valor fijo. |
CUSTOMER_PAYING_ACTUAL_FEE |
Los clientes pagarán la tarifa real de envío por devolución. |
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 |
El teléfono está verificado. |
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 ofrecen un mecanismo para agregar funciones a las cuentas de comerciante. Un ejemplo típico de esto es el programa Fichas de producto 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_uri |
Solo salida. Es la URL de una página de ayuda de Merchant Center en la que se describe el programa. |
state |
Solo salida. El estado de participación de la cuenta en el programa. |
active_region_codes[] |
Solo salida. Indica las regiones en las que la cuenta participa de forma activa en el programa. Las regiones activas se definen como aquellas en las que se cumplen todos los requisitos del programa que afectan a las regiones. CLDR define los códigos regionales. Es un país donde el programa se aplica específicamente a ese país o |
unmet_requirements[] |
Solo salida. Son 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_uri |
Solo salida. Es la URL de una página de ayuda en la que se describe el requisito. |
affected_region_codes[] |
Solo salida. No se cumplen las regiones que actualmente se ven afectadas por este requisito. CLDR define los códigos regionales. Es un país donde el programa se aplica específicamente a ese país o |
Estado
Estados posibles 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 la última puede tener un applicable_shipping_labels
vacío, que significa "todo lo demás". Los otros applicable_shipping_labels
no deben superponerse.
Campos | |
---|---|
applicable_shipping_labels[] |
Obligatorio. 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. Una lista de tablas secundarias a las que hace referencia |
carrier_rates[] |
Opcional. Es una lista de las tarifas de la empresa de transporte a las que se puede hacer referencia mediante |
single_value |
Es el valor del grupo de tarifas (por ejemplo, una tarifa plana de USD 10). Solo se puede establecer si no se configuran |
main_table |
Una tabla que define el grupo de tarifas, cuando |
name |
Opcional. Nombre del grupo de tarifas. Si se configura debe ser único dentro del servicio de envío. |
Región
Representa una región geográfica que puedes usar como destino con los servicios RegionalInventory
y ShippingSettings
. Puedes definir regiones como colecciones de códigos postales o, en algunos países, mediante segmentaciones geográficas predefinidas. Si quieres obtener más detalles, consulta Configura regiones .
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la región. Formato: |
postal_code_area |
Opcional. Es una lista de códigos postales que define el área de la región. |
geotarget_area |
Opcional. Una lista de orientaciones geográficas que define el área de la región. |
regional_inventory_eligible |
Solo salida. Indica si la región es apta para usarse en la configuración del inventario regional. |
shipping_eligible |
Solo salida. Indica si la región es apta para su uso en la configuración de los servicios de envío. |
display_name |
Opcional. Es el nombre visible de la región. |
GeoTargetArea
Una lista de orientaciones geográficas que define el área de la región.
Campos | |
---|---|
geotarget_criteria_ids[] |
Obligatorio. Una lista no vacía de IDs de ubicación. Todas deben ser del mismo tipo de ubicación (por ejemplo, un 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_code |
Obligatorio. Es el código de territorio de CLDR o el país al que se aplica el grupo de códigos postales. |
postal_codes[] |
Obligatorio. Un intervalo de códigos postales. |
PostalCodeRange
Un intervalo de códigos postales que define el área de la región.
Campos | |
---|---|
begin |
Obligatorio. Un código postal o un patrón con el prefijo de formulario* que denota el límite inferior inclusivo del rango que define el área. Valores de ejemplo: |
end |
Opcional. Un código postal o un patrón con el formato |
Obligatorio
Describe las Condiciones del Servicio que se deben aceptar.
Campos | |
---|---|
terms_of_service |
Los termsOfService que se deben aceptar. |
tos_file_uri |
URL completa del archivo de las Condiciones del Servicio. Este campo es igual a TermsOfService.file_uri, se agrega aquí solo para mayor comodidad. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
Mensaje de la solicitud para el método RetrieveForApplicationTermsOfServiceAgreementState
.
Campos | |
---|---|
parent |
Obligatorio. La cuenta para la que se obtiene el formato de Condiciones del Servicio de Acuerdo: |
RetrieveLatestTermsOfServiceRequest
Mensaje de la solicitud para el método RetrieveLatestTermsOfService
.
Campos | |
---|---|
region_code |
Código regional como lo define CLDR. Esto puede ser un país en el que las Condiciones del Servicio se aplican específicamente a ese país o el 001, cuando se aplican a nivel mundial. |
kind |
El tipo al que se aplica esta versión de las Condiciones del Servicio. |
Fila
Incluye una lista de celdas.
Campos | |
---|---|
cells[] |
Obligatorio. Lista de celdas que constituyen la fila. Debe tener la misma longitud que |
Servicio
Servicio de envío.
Campos | |
---|---|
delivery_countries[] |
Obligatorio. Es el código de territorio CLDR de los países a los que se aplica el servicio. |
rate_groups[] |
Opcional. Definiciones de grupos de tarifas de envío Solo la última puede tener un |
loyalty_programs[] |
Opcional. Programas de lealtad a los que se limita este servicio de envío. |
service_name |
Obligatorio. Es el nombre del servicio en 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_code |
Es el código CLDR de la moneda a la que se aplica este servicio. Debe coincidir con los precios de los grupos de tarifas. |
delivery_time |
Obligatorio. Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto. |
shipment_type |
Es el tipo de ubicaciones a las que este servicio envía pedidos. |
minimum_order_value |
Es el valor mínimo de pedido de este servicio. Si se establece, indica que los clientes deberán invertir, al menos, este importe. Todos los precios de un servicio deben tener la misma moneda. No se puede configurar junto conminimum_order_value_table. |
minimum_order_value_table |
Tabla de los valores de pedido mínimos por tienda para el tipo de entrega de retiro. No se puede configurar junto conminimum_order_value. |
store_config |
Es una lista de tiendas en las que se entregan tus productos. Esto solo es válido para el tipo de envío con entrega local. |
LoyaltyProgram
Programa de lealtad proporcionado por un comercio.
Campos | |
---|---|
loyalty_program_tiers[] |
Opcional. Es el nivel del programa de lealtad de este servicio de envío. |
program_label |
Es la etiqueta del programa de lealtad que se estableció 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
Subconjunto de un programa de lealtad de comercios.
Campos | |
---|---|
tier_label |
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 realizar 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 |
Este servicio envía los pedidos a una dirección elegida por el cliente. |
LOCAL_DELIVERY |
Este servicio envía los pedidos a una dirección elegida por el cliente. El pedido se envía desde una tienda local cercana. |
COLLECTION_POINT |
Este servicio envía los pedidos a una dirección elegida por el cliente. El pedido se envía desde un punto de recolección. |
StoreConfig
Es una lista de tiendas en las que se entregan tus productos. Esto solo es válido para el tipo de envío con entrega local.
Campos | |
---|---|
store_codes[] |
Opcional. Una lista de códigos de tienda que ofrecen entrega local. Si está vacío, |
store_service_type |
Indica si todas las tiendas o las tiendas seleccionadas que aparecen en este comercio ofrecen entrega local. |
cutoff_config |
Las configuraciones relacionadas con la entrega local finalizan el día. |
service_radius |
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío con entrega local. |
CutoffConfig
Las configuraciones relacionadas con la entrega local finalizan el día.
Campos | |
---|---|
local_cutoff_time |
Hora a la que finaliza la entrega local ese día. |
store_close_offset_hours |
Solo es válido con la entrega de entregas locales. Representa el horario límite como la cantidad de horas previas al cierre de la tienda. Este campo y |
no_delivery_post_cutoff |
Los comercios pueden inhabilitar la opción de entrega local n + 1 día si 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, establecer este campo en |
LocalCutoffTime
Hora a la que finaliza la entrega local ese día.
Campos | |
---|---|
hour |
Los pedidos con entrega local a la hora deben realizarse hasta el mismo día para que se procesen. |
minute |
Los pedidos con entrega local de minutos deben hacerse antes para que se procesen el mismo día. |
StoreServiceType
Indica si todas las tiendas, o las tiendas seleccionadas, indicadas por el comercio, ofrecen entrega local.
Enumeraciones | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
No se especificó el tipo de servicio de tienda. |
ALL_STORES |
Indica si todas las tiendas, actuales y futuras, de este comercio, ofrecen servicio de entrega local. |
SELECTED_STORES |
Indica que solo las tiendas que aparecen en store_codes son aptas para la entrega local. |
ShippingSettings
La [configuración de envío](https://support.google.com/merchants/answer/6069284) de la cuenta del comerciante.
Campos | |
---|---|
name |
Identificador. 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. Una lista de almacenes a los que se puede hacer referencia en |
etag |
Obligatorio. Este campo se utiliza para evitar problemas asíncronos. Asegúrate de que los datos de la configuración de envío no hayan cambiado entre las llamadas get y insert. El usuario debe seguir estos 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 constituyen la tabla. Debe tener la misma longitud que |
name |
Nombre de la tabla. Obligatorio para las tablas secundarias; se ignora para la tabla principal. |
row_headers |
Obligatorio. Encabezados de las filas de la tabla. |
column_headers |
Encabezados de las columnas de la tabla. Opcional: Si no se establece, la tabla tiene solo una dimensión. |
TermsOfService
Un objeto TermsOfService
.
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la versión de las Condiciones del Servicio. Formato: |
region_code |
Código regional como lo define CLDR. Debe ser un país donde 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 |
Si esta versión de las Condiciones del Servicio es externa. Solo se pueden aceptar las versiones externas de las Condiciones del Servicio a través de procesos externos y no el comercio directamente a través de la IU o la API. |
file_uri |
El URI del archivo de las Condiciones del Servicio que se debe mostrar a los usuarios que firman. |
TermsOfServiceAgreementState
Este recurso representa el estado del acuerdo para una cuenta determinada y un tipo de Condiciones del Servicio. El estado es el siguiente:
- Si el comercio aceptó las Condiciones del Servicio, el campo Accepted se propagará; de lo contrario, estará vacía
- Si el comercio debe firmar unas Condiciones del Servicio, el campo required se propagará; de lo contrario, estará vacía.
Ten en cuenta que pueden ser obligatorios y aceptados. En este caso, las condiciones del servicio de accepted
tendrán una fecha de vencimiento establecida en el campo valid_until. Se deben aceptar las Condiciones del Servicio de required
antes del valid_until
para que la cuenta siga teniendo un acuerdo válido. Cuando aceptamos las nuevas condiciones del servicio, esperamos que los terceros muestren el texto asociado con el acuerdo de condiciones del servicio especificado (la URL del archivo que contiene el texto se agrega en el mensaje obligatorio que aparece a continuación como tos_file_uri). La aceptación real de las Condiciones del Servicio se realiza mediante el llamado a aceptar en el recurso TermsOfService.
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la versión de las Condiciones del Servicio. Formato: |
region_code |
Código de región definido por https://cldr.unicode.org/. Este es el país al que se aplica el estado actual. |
terms_of_service_kind |
Es el tipo de las Condiciones del Servicio asociado a la versión específica. |
accepted |
Las Condiciones del Servicio aceptadas de este tipo y para la region_code asociada |
required |
Las Condiciones del Servicio requeridas |
TermsOfServiceKind
Las categorías de Términos de servicio
Enumeraciones | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
MERCHANT_CENTER |
App de Merchant Center. |
TransitTable
Tabla de tiempo en tránsito, que corresponde a la cantidad de días hábiles que se pasaron 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_code_group_names[] |
Obligatorio. Una lista de nombres de regiones |
transit_time_labels[] |
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 una postal_code_group_names
y las columnas (valores) a una transit_time_labels
.
Campos | |
---|---|
values[] |
Obligatorio. Es el intervalo de tiempo en tránsito (mín.-máx.) en días hábiles. |
TransitTimeValue
Es el intervalo de tiempo en tránsito (mín.-máx.) en días hábiles.
Campos | |
---|---|
min_transit_days |
Intervalo de tiempo mínimo en tránsito en días hábiles. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. |
max_transit_days |
Debe ser mayor o igual que |
UnclaimHomepageRequest
Mensaje de la solicitud para el método UnclaimHomepage
.
Campos | |
---|---|
name |
Obligatorio. El nombre de la página principal que se debe retirar. Formato: |
UpdateAccountRequest
Mensaje de la solicitud para el método UpdateAccount
.
Campos | |
---|---|
account |
Obligatorio. La nueva versión de la cuenta. |
update_mask |
Obligatorio. Lista de campos que se están actualizando. |
UpdateBusinessIdentityRequest
Mensaje de la solicitud para el método UpdateBusinessIdentity
.
Campos | |
---|---|
business_identity |
Obligatorio. La versión nueva de la identidad de la empresa. |
update_mask |
Obligatorio. Lista de campos que se están actualizando. |
UpdateBusinessInfoRequest
Mensaje de la solicitud para el método UpdateBusinessInfo
.
Campos | |
---|---|
business_info |
Obligatorio. La nueva versión de la información de la empresa. |
update_mask |
Obligatorio. Lista de campos que se están actualizando. |
UpdateEmailPreferencesRequest
Mensaje de solicitud para el método UpdateEmailPreferences.
Campos | |
---|---|
email_preferences |
Obligatorio. Se actualizarán las preferencias de correo electrónico. |
update_mask |
Obligatorio. Lista de campos que se están actualizando. |
UpdateHomepageRequest
Mensaje de la solicitud para el método UpdateHomepage
.
Campos | |
---|---|
homepage |
Obligatorio. La nueva versión de la página principal. |
update_mask |
Obligatorio. Lista de campos que se están actualizando. |
UpdateRegionRequest
Mensaje de la solicitud para el método UpdateRegion
.
Campos | |
---|---|
region |
Obligatorio. La región actualizada. |
update_mask |
Opcional. 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_mask |
Obligatorio. Lista de campos que se están actualizando. |
Usuario
Un usuario.
Campos | |
---|---|
name |
Identificador. Es el nombre del recurso del usuario. Formato: Usa |
state |
Solo salida. El estado del usuario. |
access_rights[] |
Opcional. Son los derechos de acceso que tiene el usuario. |
Estado
Son los posibles estados de un usuario.
Enumeraciones | |
---|---|
STATE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
PENDING |
La confirmación del usuario está pendiente. En este estado, el usuario primero debe aceptar la invitación antes de realizar otras acciones. |
VERIFIED |
El usuario está verificado. |
Valor
El valor único de un grupo de tarifas o el valor de la celda de la tabla de un grupo de tarifas. Se debe establecer exactamente uno de los siguientes valores: no_shipping
, flat_rate
, price_percentage
, carrier_rateName
o subtable_name
.
Campos | |
---|---|
no_shipping |
Si es "true", el producto no se puede enviar. Debe ser verdadera cuando se establece; solo se puede establecer si no se establecen todos los demás campos. |
flat_rate |
Una tarifa plana. Solo se puede establecer si no están configurados todos los demás campos. |
price_percentage |
Es un porcentaje del precio representado como un número en notación decimal (por ejemplo, |
carrier_rate |
Es el nombre de la tarifa de una empresa de transporte que hace referencia a una tarifa de la empresa de transporte definida en el mismo grupo de tarifas. Solo se puede establecer si no están configurados todos los demás campos. |
subtable |
Es el nombre de una tabla secundaria. Solo se puede establecer en las celdas de la tabla (por ejemplo, no para valores individuales) y solo si no se configuran todos los demás campos. |
Almacén
Un almacén de entrega, que almacena y maneja inventario Siguiente etiqueta: 7
Campos | |
---|---|
name |
Obligatorio. El nombre del almacén Debe ser único en la cuenta. |
shipping_address |
Obligatorio. Dirección de envío del almacén. |
cutoff_time |
Obligatorio. El último momento del día en que se puede aceptar un pedido y comenzar a procesarse. Los pedidos posteriores se procesarán al día siguiente. La hora se basa en el código postal del almacén. |
handling_days |
Obligatorio. Es la cantidad de días que tarda este almacén en empacar y enviar un artículo. Esto se encuentra a nivel del almacén, pero se puede anular a nivel de la oferta según los atributos de un artículo. |
business_day_config |
Días hábiles del depósito Si no la estableces, 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 en tránsito en delivery_time
.
Campos | |
---|---|
carrier |
Obligatorio. Proveedor, como |
carrier_service |
Obligatorio. Servicio del operador, como |
warehouse |
Obligatorio. Nombre del almacén. Debería coincidir con [warehouse][ShippingSetting.warehouses.name]. |
WarehouseCutoffTime
El último momento del día en que se puede aceptar un pedido y comenzar a procesarse. Los pedidos posteriores se procesarán al día siguiente. La hora se basa en el código postal del almacén.
Campos | |
---|---|
hour |
Obligatorio. Es la hora 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. 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. |