Índice
AccountIssueService
(interfaz)AccountTaxService
(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)AccountTax
(mensaje)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)GetAccountTaxRequest
(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)ListAccountTaxRequest
(mensaje)ListAccountTaxResponse
(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)TaxRule
(mensaje)TaxRule.TaxPostalCodeRange
(mensaje)TermsOfService
(mensaje)TermsOfServiceAgreementState
(mensaje)TermsOfServiceKind
(enumeración)TransitTable
(mensaje)TransitTable.TransitTimeRow
(mensaje)TransitTable.TransitTimeRow.TransitTimeValue
(mensaje)UnclaimHomepageRequest
(mensaje)UpdateAccountRequest
(mensaje)UpdateAccountTaxRequest
(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.
|
AccountTaxService
Administra los datos de la configuración de impuestos a nivel de la cuenta.
Esta API define el siguiente modelo de recursos:
AccountTax
GetAccountTax |
---|
Devuelve las reglas fiscales que coinciden con las condiciones de GetAccountTaxRequest
|
ListAccountTax |
---|
Indica la configuración fiscal de las cuentas secundarias solo en tu cuenta de Merchant Center. Este método solo se puede llamar en una cuenta de varios clientes; de lo contrario, mostrará un error.
|
UpdateAccountTax |
---|
Actualiza la configuración fiscal de la cuenta.
|
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 |
---|
Obtén una lista de 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: el usuario 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; - el reclamo falló (en este caso, el mensaje de error contendrá más detalles).
|
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
Servicio para obtener información de la configuración de envío de llamadas de método por 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.
Enumeradores | |
---|---|
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 legible por humanos. 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. Es 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.
Enumeradores | |
---|---|
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. |
AccountTax
Es la configuración de impuestos de una cuenta de comerciante. Todos los métodos requieren el rol de administrador.
Campos | |
---|---|
name |
Identificador. Es el nombre de la configuración de impuestos. Formato: “{account_tax.name=accounts/{account}}" |
account |
Solo salida. Es el ID de la cuenta a la que pertenece esta configuración de impuestos de la cuenta. |
tax_rules[] |
Reglas fiscales "Define las reglas fiscales en cada región. Si una región no tiene ninguna regla, no se presentarán impuestos”. |
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 la semana
Enumeradores | |
---|---|
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 se haya establecido 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.
Enumeradores | |
---|---|
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.
Enumeradores | |
---|---|
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 |
Opcional. 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. |
CarrierRate
Una lista de tarifas de empresas 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[] |
Opcional. Si se especifica, se inicializará un servicio de cuenta entre la cuenta que se creará y la cuenta de proveedor como parte de la creación. |
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 |
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.
Enumeradores | |
---|---|
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.
Enumeradores | |
---|---|
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: |
GetAccountTaxRequest
Solicita la configuración de impuestos
Campos | |
---|---|
name |
Obligatorio. El nombre a partir del cual se recuperará la configuración de impuestos |
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 valor del último peso puede ser infinito si estableces price amount_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 la estableces, se usará “America/Los_Angeles”. |
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 |
ListAccountTaxRequest
Solicitud para enumerar toda la configuración de impuestos de las cuentas secundarias solo para el comercio que realiza la solicitud. Este método solo se puede llamar en una cuenta de varios clientes. De lo contrario, se mostrará un error.
Campos | |
---|---|
parent |
Obligatorio. El publicador superior, propietario de esta colección de impuestos de la cuenta. Formato: cuentas/{account} |
page_size |
La cantidad máxima de configuraciones de impuestos que se mostrarán en la respuesta, que se usa para la paginación. |
page_token |
El token que muestra la solicitud anterior. |
ListAccountTaxResponse
Respuesta a la solicitud de lista de impuestos de la cuenta. Este método solo se puede invocar en una cuenta de varios clientes. De lo contrario, se mostrará un error.
Campos | |
---|---|
account_taxes[] |
Página de la configuración de impuestos de la cuenta |
next_page_token |
El token para recuperar la página siguiente de la configuración de impuestos de la cuenta. |
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 devolverán 250 cuentas como máximo. El valor máximo es 500; los valores superiores a 500 se convertirán en 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. Es un filtro opcional para mostrar solo las cuentas que coinciden con el filtro. Estos son algunos ejemplos de filtros válidos:
Los filtros a nivel de la cuenta tienen la siguiente semántica:
Los filtros en el nivel de relación tienen la siguiente semántica:
Los filtros en el nivel de servicio tienen la siguiente semántica:
El filtro sigue un subconjunto de la especificación del filtro AIP y su gramática formal EBNF. La gramática de este filtro es más restrictiva y específica.
Además, se aplica lo siguiente:
|
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. 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 devolverán 250 cuentas como máximo. El valor máximo es 500; los valores superiores a 500 se convertirán en 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: `accounts/{account} |
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.
Enumeradores | |
---|---|
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.
Enumeradores | |
---|---|
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.
Enumeradores | |
---|---|
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.
Enumeradores | |
---|---|
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.
Enumeradores | |
---|---|
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 |
Program
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.
Enumeradores | |
---|---|
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. Una lista de tarifas de empresas 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. 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.
Enumeradores | |
---|---|
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 antes del 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.
Enumeradores | |
---|---|
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. |
TaxRule
Convención de tipo principal
porcentaje micro : 100% = 1 000 000 y 1% = 10 000 no pueden ser negativos.
Información sobre nexos fiscales y parámetros relacionados aplicables a los pedidos entregados en el área cubierta por un único administrador fiscal. El nexo se crea cuando un comercio opera en un área administrada por el administrador fiscal (solo se admiten los estados de EE.UU. para la configuración de nexos). Si el comercio tiene nexo fiscal en un estado de EE.UU., debe pagar impuestos a todas las autoridades fiscales asociadas con el destino de envío. Next Id : 8
Campos | |
---|---|
region_code |
Código regional en el que se aplica esta regla |
shipping_taxed |
Si se establece, se gravará el cargo de envío (con la misma tarifa que el producto) cuando se entregue en el área de este administrador. Solo se puede configurar en estados de EE.UU. sin una categoría. |
effective_time_period |
Obligatorio. Período en el que esta regla entró en vigencia. Si falta la duración deeffective_time enumerada, entonces es abierta para el futuro. El inicio de este período es inclusivo y el final es exclusivo. |
Campo de unión location . Describe la ubicación mediante un intervalo de códigos postales o un ID de criterios. Las direcciones (location ) solo pueden ser una de las siguientes opciones: |
|
location_id |
El admin_id oEl_id_criterios de la región en la que se aplica esta regla. |
post_code_range |
El intervalo de códigos postales al que se aplica esta regla. |
Campo de unión rate_calculation . ¿Cómo se calcula la tasa impositiva para las entregas en el área de este administrador? Solo se puede configurar en estados de EE.UU. Las direcciones (rate_calculation ) solo pueden ser una de las siguientes opciones: |
|
use_google_rate |
Tarifa que depende de la ubicación de entrega: Si el comercio tiene nexo fiscal en el estado correspondiente de EE.UU., se suman las tarifas de las autoridades con jurisdicción sobre el área de entrega. |
self_specified_rate_micros |
Una tasa fija especificada en micros, donde 100% = 1_000_000. Apto para estados basados en el origen. |
TaxPostalCodeRange
Un intervalo de códigos postales que define el área.
Campos | |
---|---|
start |
Obligatorio. Indica el inicio del intervalo de códigos postales, que también es el más pequeño del intervalo. |
end |
Final del intervalo de códigos postales. Será la misma que la de inicio si no se especifica. |
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 |
Son 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
Enumeradores | |
---|---|
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. |
UpdateAccountTaxRequest
Cómo solicitar la actualización de la configuración fiscal
Campos | |
---|---|
account_tax |
Obligatorio. La configuración de impuestos que se actualizará |
update_mask |
La lista de campos que se actualizarán |
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. También es posible actualizar el usuario que corresponde al emisor mediante |
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: |
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.
Enumeradores | |
---|---|
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 |
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. |