Package google.shopping.merchant.accounts.v1beta

Índice

AccountIssueService

Servicio para admitir la API de AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Muestra una lista de todos los problemas de una cuenta de Merchant Center.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

AccountsService

Servicio para admitir la API de Accounts.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Crea una cuenta independiente de Merchant Center con configuración adicional. Agrega al usuario que realiza la solicitud como administrador de la cuenta nueva.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Borra la cuenta especificada, independientemente de su tipo: independiente, MCA o cuenta secundaria. Si borras una MCA, se borrarán todas sus cuentas secundarias. Para ejecutar este método, se requiere acceso de administrador. La eliminación se realiza correctamente solo si la cuenta no proporciona servicios a ninguna otra cuenta y no tiene ofertas procesadas. Puedes usar el parámetro force para anular esta acción.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Recupera una cuenta de tu cuenta de Merchant Center. Después de insertar, actualizar o borrar una cuenta, es posible que los cambios demoren varios minutos en aplicarse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Muestra las cuentas a las que puede acceder el usuario que realiza la llamada y que coinciden con las restricciones de la solicitud, como el tamaño de la página o los filtros. Esto no solo muestra las cuentas secundarias de una MCA, sino todas las cuentas a las que tiene acceso el usuario que realiza la llamada, incluidas otras MCA, cuentas vinculadas, cuentas independientes, etcétera. Si no se proporciona ningún filtro, se muestran las cuentas a las que se agregó directamente el usuario. Este método tiene coherencia eventual, lo que significa que es posible que los cambios, como la creación o actualización de una cuenta, o un cambio de relaciones entre cuentas, no aparezcan en los resultados de inmediato. En cambio, estos cambios se propagan durante un período breve, después del cual la información actualizada puede coincidir con los predicados asociados. Esto significa que, si buscas por nombre de cuenta, es posible que no se muestre una cuenta que se haya modificado recientemente, aunque satisfaga el predicado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Muestra una lista de todas las cuentas secundarias de una cuenta de varios clientes determinada. Este es un wrapper de conveniencia para el método ListAccounts más potente. Este método producirá los mismos resultados que llamar a ListsAccounts con el siguiente filtro: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Actualiza una cuenta independientemente de su tipo: independiente, MCA o cuenta secundaria. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

AutofeedSettingsService

Servicio para admitir la configuración de alimentación automática.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

Recupera la configuración del feed automático de una cuenta.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

Actualiza la configuración del feed automático de una cuenta.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

BusinessIdentityService

Servicio para admitir la API de identidad de la empresa.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Recupera la identidad de la empresa de una cuenta.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Actualiza la identidad de la empresa de una cuenta. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

BusinessInfoService

Servicio para admitir la API de información de la empresa.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Recupera la información de la empresa de una cuenta.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Actualiza la información de la empresa de una cuenta. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

EmailPreferencesService

Servicio para admitir la API de EmailPreferences.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Muestra las preferencias de correo electrónico de un usuario de una cuenta de Merchant Center. Este servicio solo permite recuperar y actualizar las preferencias de correo electrónico del usuario autenticado. Usa el alias name=accounts/*/users/me/emailPreferences para obtener las preferencias del usuario autenticado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Actualiza las preferencias de correo electrónico de un usuario de una cuenta de Merchant Center. Los usuarios de la MCA deben especificar la cuenta de la MCA en lugar de una cuenta secundaria de la MCA.

No se actualizarán las preferencias que no se seleccionen de forma explícita en la máscara de actualización.

No es válido que las actualizaciones especifiquen un valor de estado de habilitación NO CONFIRMADO.

Usa el alias name=accounts/*/users/me/emailPreferences para actualizar las preferencias del usuario autenticado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

HomepageService

Servicio para admitir una API para la página principal de una tienda.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Reclama la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador.

Si la página principal ya se reclamó, se volverá a verificar la verificación (a menos que el comercio esté exento de reclamar, lo que también lo exime de la verificación) y se mostrará una respuesta correcta. Si ya no se puede verificar la propiedad, se mostrará un error, pero no se borrará el reclamo. En caso de que se produzca un error, se mostrará un mensaje de error canónico: * PERMISSION_DENIED: El usuario no tiene los permisos necesarios en esta cuenta de MC. * FAILED_PRECONDITION: - La cuenta no es una cuenta de Merchant Center. - La cuenta de MC no tiene una página principal. - El reclamo falló (en este caso, el mensaje de error contendrá más detalles).

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Recupera la página principal de una tienda.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Cancela la reclamación de la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Actualiza la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

OnlineReturnPolicyService

El servicio facilita la administración de la configuración de la política de devoluciones por arrepentimiento de un comercio, lo que abarca las políticas de devoluciones de los anuncios y las fichas gratuitas.

programas. Esta API define el siguiente modelo de recursos:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Obtiene una política de devoluciones existente para un comercio determinado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Muestra todas las políticas de devoluciones existentes de un comercio determinado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ProgramsService

Servicio para la administración de programas.

Los programas proporcionan un mecanismo para agregar funciones a las cuentas de comerciante. Un ejemplo típico de esto es el programa de fichas de productos gratuitas, que permite que los productos de la tienda de un comercio se muestren en Google de forma gratuita.

Este servicio expone métodos para recuperar la participación de un comercio en todos los programas disponibles, además de métodos para habilitar o inhabilitar de forma explícita la participación en cada programa.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Inhabilita la participación en el programa especificado para la cuenta. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Habilita la participación en el programa especificado para la cuenta. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Recupera el programa especificado para la cuenta.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Recupera todos los programas de la cuenta.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

RegionsService

Administra la configuración de las regiones.

Esta API define el siguiente modelo de recursos:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Crea una definición de región en tu cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Borra la definición de una región de tu cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Recupera una región definida en tu cuenta de Merchant Center.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Muestra las regiones de tu cuenta de Merchant Center.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Actualiza la definición de una región en tu cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ShippingSettingsService

Servicio para obtener información de configuración de envío de llamadas de método por método de la API de Merchant.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Recupera información de la configuración de envío.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Reemplaza la configuración de envío de un comercio por la configuración de envío de la solicitud. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

TermsOfServiceAgreementStateService

Servicio para admitir la API de TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Muestra el estado de un acuerdo de las Condiciones del Servicio.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Recupera el estado del acuerdo de las Condiciones del Servicio de la aplicación.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

TermsOfServiceService

Servicio para admitir la API de TermsOfService.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Acepta un TermsOfService. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Recupera el TermsOfService asociado con la versión proporcionada.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Recupera la versión más reciente de TermsOfService para un kind y region_code determinados.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UserService

Servicio para admitir la API de usuario.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Crea un usuario de la cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Borra un usuario de la cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador. El usuario que se borrará no puede ser el último usuario administrador de esa cuenta. Además, un usuario está protegido contra la eliminación si lo administra el Administrador de Negocio".

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

GetUser

rpc GetUser(GetUserRequest) returns (User)

Recupera un usuario de una cuenta de Merchant Center.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Muestra una lista de todos los usuarios de una cuenta de Merchant Center.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Actualiza un usuario de la cuenta de Merchant Center. Para ejecutar este método, se requiere acceso de administrador.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

AcceptTermsOfServiceRequest

Mensaje de la solicitud para el método AcceptTermsOfService.

Campos
name

string

Obligatorio. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: termsOfService/{version}

account

string

Obligatorio. La cuenta para la que se aceptan las Condiciones del Servicio

region_code

string

Obligatorio. Es el código de región según se define en CLDR. Es un país cuando las Condiciones del Servicio se aplican específicamente a ese país o 001 cuando se aplican a nivel global.

Aceptado

Describe las Condiciones del Servicio aceptadas.

Campos
terms_of_service

string

Los termsOfService aceptados.

accepted_by

string

Es la cuenta en la que se registró la aceptación. Puede ser la cuenta en sí o, en el caso de las cuentas secundarias, la cuenta de la MCA.

valid_until

Date

Cuando se establece, se indica que las TermsOfService aceptadas solo son válidas hasta el final de esta fecha (en UTC). Se debe aceptar una nueva antes de esa fecha. La información de los TermsOfService obligatorios se encuentra en el mensaje Required.

AccessRight

El derecho de acceso

Enumeraciones
ACCESS_RIGHT_UNSPECIFIED Valor predeterminado Este valor no se usa.
STANDARD Derechos de acceso estándar.
ADMIN Derechos de acceso de administrador
PERFORMANCE_REPORTING Los usuarios con este derecho tienen acceso al rendimiento y las estadísticas.

Cuenta

El mensaje Account representa la cuenta de un comercio en los anuncios de Shopping. Es la entidad principal para administrar los datos de productos, la configuración y las interacciones con los servicios de Google y los proveedores externos.

Las cuentas pueden funcionar como entidades independientes o formar parte de una estructura de cuenta de varios clientes (MCA). En una configuración de MCA, la cuenta superior administra varias cuentas secundarias.

Para establecer una cuenta, debes configurar atributos como el nombre de la cuenta, la zona horaria y las preferencias de idioma.

El mensaje Account es la entidad superior de muchos otros recursos, por ejemplo, AccountRelationship, Homepage, BusinessInfo, etcétera.

Campos
name

string

Identificador. Es el nombre del recurso de la cuenta. Formato: accounts/{account}

account_id

int64

Solo salida. Es el ID de la cuenta.

account_name

string

Obligatorio. Es el nombre legible de la cuenta. Consulta nombre de la tienda y nombre de la empresa para obtener más información.

adult_content

bool

Si la cuenta incluye contenido para adultos

test_account

bool

Solo salida. Indica si se trata de una cuenta de prueba.

time_zone

TimeZone

Obligatorio. Es la zona horaria de la cuenta.

En las operaciones de escritura, time_zone establece reporting_time_zone y display_time_zone.

Para las operaciones de lectura, time_zone siempre muestra display_time_zone. Si display_time_zone no existe para tu cuenta, time_zone estará vacío.

language_code

string

Obligatorio. El código de idioma BCP-47 de la cuenta, como en-US o sr-Latn

AccountAggregation

Este tipo no tiene campos.

Carga útil AccountAggregation.

AccountIssue

Un AccountIssue.

Campos
name

string

Identificador. Es el nombre del recurso del problema de la cuenta. Formato: accounts/{account}/issues/{id}

title

string

Es el título localizado del problema.

severity

Severity

La gravedad general del problema.

impacted_destinations[]

ImpactedDestination

El impacto que tiene este problema en varios destinos

detail

string

Más detalles localizados sobre el problema.

documentation_uri

string

Vínculo al Centro de ayuda de Merchant Center que proporciona más información sobre el problema y cómo solucionarlo

ImpactedDestination

El impacto del problema en un destino

Campos
impacts[]

Impact

El impacto (negativo) de varias regiones en el destino determinado.

reporting_context

ReportingContextEnum

El contexto de informes afectado

Impacto

El impacto del problema en una región

Campos
region_code

string

Es el código de región de CLDR en el que se aplica este problema.

severity

Severity

La gravedad del problema en el destino y la región

Gravedad

Todos los niveles de gravedad posibles

Enumeraciones
SEVERITY_UNSPECIFIED Se desconoce la gravedad.
CRITICAL El problema hace que las ofertas no se publiquen.
ERROR El problema podría afectar las ofertas (en el futuro) o ser un indicador de problemas con las ofertas.
SUGGESTION El problema es una sugerencia para mejorar.

Dirección

Es la dirección de envío del almacén.

Campos
street_address

string

Es la parte de la dirección a nivel de la calle. Por ejemplo: 111w 31st Street.

city

string

Obligatorio. Ciudad, pueblo o comuna También puede incluir localidades o sublocalidades dependientes (por ejemplo, vecindarios o suburbios).

administrative_area

string

Obligatorio. Es la subdivisión administrativa principal del país. Por ejemplo, un estado como California ("CA") o una provincia como Quebec ("QC").

postal_code

string

Obligatorio. Código postal (por ejemplo, “94043”).

region_code

string

Obligatorio. Código de país de CLDR (por ejemplo, “US”).

AutofeedSettings

Recopilación de información relacionada con la configuración del feed automático.

Campos
name

string

Identificador. Es el nombre del recurso de la configuración del feed automático. Formato: accounts/{account}/autofeedSettings.

enable_products

bool

Obligatorio. Habilita o inhabilita el rastreo de productos a través del feed automático de la cuenta determinada. Las cuentas de feeds automáticos deben cumplir con ciertas condiciones, que se pueden verificar a través del campo eligible. La cuenta no debe ser un mercado. Cuando se habilita el feed automático por primera vez, los productos suelen aparecer de inmediato. Cuando vuelvas a habilitar la función, los productos pueden tardar hasta 24 horas en aparecer.

eligible

bool

Solo salida. Determina si el comercio es apto para inscribirse en un feed automático.

BusinessDayConfig

Son los días hábiles del almacén.

Campos
business_days[]

Weekday

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

string

Identificador. Es el nombre del recurso de la identidad de la empresa. Formato: accounts/{account}/businessIdentity

black_owned

IdentityAttribute

Opcional. Especifica si la empresa se identifica como de propiedad de personas negras. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en US. Tampoco se aplica a los mercados ni a los vendedores de mercados.

women_owned

IdentityAttribute

Opcional. Especifica si la empresa se identifica como una empresa de mujeres. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en US. Tampoco se aplica a los mercados ni a los vendedores de mercados.

veteran_owned

IdentityAttribute

Opcional. Especifica si la empresa se identifica como de propiedad de veteranos. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en US. Tampoco se aplica a los mercados ni a los vendedores de mercados.

latino_owned

IdentityAttribute

Opcional. Especifica si la empresa se identifica como de propiedad latina. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en US. Tampoco se aplica a los mercados ni a los vendedores de mercados.

small_business

IdentityAttribute

Opcional. Especifica si la empresa se identifica como una pequeña empresa. Este campo opcional solo estará disponible para los comercios que tengan un país de la empresa establecido en US. Tampoco se aplica a los mercados.

IdentityAttribute

Toda la información relacionada con un atributo de identidad.

Campos
identity_declaration

IdentityDeclaration

Obligatorio. La declaración de identidad de este atributo.

IdentityDeclaration

Todos los parámetros de configuración posibles relacionados con la declaración de una identidad

Enumeraciones
IDENTITY_DECLARATION_UNSPECIFIED Es el valor predeterminado que indica que no se realizó ninguna selección.
SELF_IDENTIFIES_AS Indica que la cuenta se identifica con el atributo.
DOES_NOT_SELF_IDENTIFY_AS Indica que la cuenta no se identifica con el atributo.

PromotionsConsent

Todos los parámetros de configuración posibles relacionados con las promociones de la identidad de la empresa

Enumeraciones

BusinessInfo

El mensaje BusinessInfo contiene información esencial sobre la empresa de un comercio.

Este mensaje captura detalles clave de la empresa, como la dirección física, los contactos del servicio de atención al cliente y los identificadores específicos de la región.

Campos
name

string

Identificador. Es el nombre del recurso de la información de la empresa. Formato: accounts/{account}/businessInfo

address

PostalAddress

Opcional. Es la dirección de la empresa. Solo se admiten los campos region_code, address_lines, postal_code, administrative_area y locality. Se ignoran todos los demás campos.

phone

PhoneNumber

Solo salida. El número de teléfono de la empresa

phone_verification_state

PhoneVerificationState

Solo salida. El estado de verificación telefónica de la empresa

customer_service

CustomerService

Opcional. El servicio de atención al cliente de la empresa.

korean_business_registration_number

string

Opcional. El número de registro comercial coreano de 10 dígitos separado por guiones con el formato XXX-XX-XXXXX

CarrierRate

Es una lista de tarifas de operadores a las que se puede hacer referencia con main_table o single_value. Los servicios de operadores admitidos se definen en https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Campos
name

string

Obligatorio. Es el nombre de la tarifa del operador. Debe ser único por grupo de tarifas.

carrier

string

Obligatorio. Servicio de operador, como "UPS" o "Fedex"

carrier_service

string

Obligatorio. Servicio de operador, como "ground" o "2 days"

origin_postal_code

string

Obligatorio. Es el origen de envío para esta tarifa del transportista.

percentage_adjustment

string

Opcional. Es el modificador multiplicativo de la tarifa de envío como un número en notación decimal. Puede ser negativo. Por ejemplo, "5.4" aumenta la tasa en un 5.4% y "-3" la disminuye en un 3%.

flat_adjustment

Price

Opcional. Es un modificador aditivo de la tarifa de envío. Puede ser negativo. Por ejemplo, { "amount_micros": 1, "currency_code" : "USD" } agrega USD 1 a la tarifa y { "amount_micros": -3, "currency_code" : "USD" } quita USD 3 de la tarifa.

ClaimHomepageRequest

Mensaje de la solicitud para el método ClaimHomepage.

Campos
name

string

Obligatorio. Es el nombre de la página principal que se reclamará. Formato: accounts/{account}/homepage

overwrite

bool

Opcional. Cuando se establece en true, esta opción quita cualquier reclamo existente en el sitio web solicitado y lo reemplaza por un reclamo de la cuenta que realiza la solicitud.

CreateAndConfigureAccountRequest

Mensaje de la solicitud para el método CreateAndConfigureAccount.

Campos
account

Account

Obligatorio. La cuenta que se creará.

users[]
(deprecated)

CreateUserRequest

Opcional. Usuarios que se agregarán a la cuenta.

Este campo dejó de estar disponible y no existirá después de que la API deje de estar en versión beta. En su lugar, usa el campo user.

user[]

AddUser

Opcional. Usuarios que se agregarán a la cuenta.

service[]

AddAccountService

Obligatorio. Como parte de la creación, se inicializa un servicio de cuenta entre la cuenta que se creará y la cuenta del proveedor. Se debe proporcionar al menos uno de esos servicios. Actualmente, exactamente uno de ellos debe ser account_aggregation, lo que significa que solo puedes crear cuentas secundarias, no cuentas independientes, a través de este método. Se pueden proporcionar servicios adicionales de account_management o product_management.

AddAccountService

Instrucciones adicionales para agregar servicios de la cuenta durante la creación de la cuenta.

Campos
Campo de unión service_type. Es el tipo de servicio que se agregará. Las direcciones (service_type) solo pueden ser una de las siguientes opciones:
account_aggregation

AccountAggregation

El proveedor es un agregador de la cuenta. Carga útil para el tipo de servicio Account Aggregation.

provider

string

Obligatorio. El proveedor del servicio. La referencia a una cuenta, como providers/123, o a un proveedor de servicios conocido (uno de providers/GOOGLE_ADS o providers/GOOGLE_BUSINESS_PROFILE)

AddUser

Instrucción para agregar un usuario a la cuenta durante su creación.

Campos
user_id

string

Obligatorio. Es la dirección de correo electrónico del usuario (por ejemplo, john.doe@gmail.com).

user

User

Opcional. Detalles sobre el usuario que se agregará. Por el momento, solo se pueden especificar los derechos de acceso.

CreateRegionRequest

Mensaje de la solicitud para el método CreateRegion.

Campos
parent

string

Obligatorio. La cuenta para la que se creará una región. Formato: accounts/{account}

region_id

string

Obligatorio. Es el identificador de la región, único en todas las regiones de la misma cuenta.

region

Region

Obligatorio. La región que se creará.

CreateUserRequest

Mensaje de la solicitud para el método CreateUser.

Campos
parent

string

Obligatorio. Es el nombre del recurso de la cuenta para la que se creará un usuario. Formato: accounts/{account}

user_id

string

Obligatorio. Es la dirección de correo electrónico del usuario (por ejemplo, john.doe@gmail.com).

user

User

Opcional. El usuario que se creará.

CustomerService

Información de atención al cliente

Campos
uri

string

Opcional. Es el URI en el que se puede encontrar el servicio de atención al cliente.

email

string

Opcional. La dirección de correo electrónico a la que se puede comunicar el servicio de atención al cliente.

phone

PhoneNumber

Opcional. Es el número de teléfono al que se puede llamar para comunicarse con el servicio de atención al cliente.

CutoffTime

Definición del horario límite de los días hábiles.

Campos
hour

int32

Obligatorio. Es la hora del horario límite hasta la que se debe realizar un pedido para que se procese el mismo día.

minute

int32

Obligatorio. Es el minuto del horario límite hasta el que se debe realizar un pedido para que se procese el mismo día.

time_zone

string

Obligatorio. Identificador de zona horaria. Por ejemplo, "Europe/Zurich".

DeleteAccountRequest

Mensaje de la solicitud para el método DeleteAccount.

Campos
name

string

Obligatorio. El nombre de la cuenta que se borrará. Formato: accounts/{account}

force

bool

Opcional. Si se establece en true, la cuenta se borra, incluso si proporciona servicios a otras cuentas o procesó ofertas.

DeleteRegionRequest

Mensaje de la solicitud para el método DeleteRegion.

Campos
name

string

Obligatorio. Es el nombre de la región que se borrará. Formato: accounts/{account}/regions/{region}

DeleteUserRequest

Mensaje de la solicitud para el método DeleteUser.

Campos
name

string

Obligatorio. Es el nombre del usuario que se borrará. Formato: accounts/{account}/users/{email}

También es posible borrar al usuario correspondiente al llamador usando me en lugar de una dirección de correo electrónico, como en accounts/{account}/users/me.

DeliveryTime

Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.

Campos
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Opcional. Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se establece, no se debe configurar ningún otro campo relacionado con el tiempo en tránsito en [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime].

min_transit_days

int32

Es la cantidad mínima de días hábiles que se tarda en el envío. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. Se debe configurar min_transit_days, max_transit_days o transit_time_table, pero no ambos.

max_transit_days

int32

Es la cantidad máxima de días hábiles que se pasan en tránsito. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. Debe ser mayor o igual que min_transit_days.

cutoff_time

CutoffTime

Definición del horario límite de los días hábiles. Si no se configura, la hora límite se establecerá de forma predeterminada a las 8 a.m. (PST).

min_handling_days

int32

Es la cantidad mínima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. "min_handling_days" y "max_handling_days" deben configurarse o no al mismo tiempo.

max_handling_days

int32

Es la cantidad máxima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. Debe ser mayor o igual que min_handling_days. "min_handling_days" y "max_handling_days" deben configurarse o no al mismo tiempo.

transit_time_table

TransitTable

Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de filas y columnas Se puede configurar min_transit_days, max_transit_days o transit_time_table, pero no ambos.

handling_business_day_config

BusinessDayConfig

Son los días hábiles durante los cuales se pueden procesar los pedidos. Si no se proporciona, se supondrán días hábiles de lunes a viernes.

transit_business_day_config

BusinessDayConfig

Son los días hábiles durante los cuales los pedidos pueden estar en tránsito. Si no se proporciona, se supondrán días hábiles de lunes a viernes.

DisableProgramRequest

Mensaje de solicitud para el método DisableProgram.

Campos
name

string

Obligatorio. Es el nombre del programa para el que se inhabilitará la participación de la cuenta determinada. Formato: accounts/{account}/programs/{program}

Distancia

Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local.

Campos
value

int64

Es el valor de número entero de la distancia.

unit

Unit

La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros.

Unidad

La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros.

Enumeraciones
UNIT_UNSPECIFIED Unidad no especificada
MILES Unidad en millas
KILOMETERS Unidad en kilómetros

EmailPreferences

Las categorías de notificaciones que el usuario habilitó o inhabilitó Las preferencias de correo electrónico no incluyen anuncios obligatorios, ya que los usuarios no pueden inhabilitarlos.

Campos
name

string

Identificador. Es el nombre de EmailPreferences. El extremo solo es compatible con el usuario autenticado.

news_and_tips

OptInState

Opcional. Actualizaciones sobre funciones nuevas, sugerencias y prácticas recomendadas

OptInState

Estado de habilitación de la preferencia de correo electrónico

Enumeraciones
OPT_IN_STATE_UNSPECIFIED No se especifica el estado de habilitación.
OPTED_OUT El usuario inhabilitó la recepción de este tipo de correo electrónico.
OPTED_IN El usuario aceptó recibir este tipo de correo electrónico.
UNCONFIRMED El usuario aceptó recibir este tipo de correo electrónico y se le envió el correo electrónico de confirmación, pero aún no lo confirmó (solo se aplica a ciertos países).

EnableProgramRequest

Es un mensaje de solicitud para el método EnableProgram.

Campos
name

string

Obligatorio. Es el nombre del programa para el que se habilitará la participación de la cuenta determinada. Formato: accounts/{account}/programs/{program}

GetAccountRequest

Mensaje de la solicitud para el método GetAccount.

Campos
name

string

Obligatorio. Es el nombre de la cuenta que se recuperará. Formato: accounts/{account}

GetAutofeedSettingsRequest

Mensaje de la solicitud para el método GetAutofeedSettings.

Campos
name

string

Obligatorio. Es el nombre del recurso de la configuración del feed automático. Formato: accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

Mensaje de la solicitud para el método GetBusinessIdentity.

Campos
name

string

Obligatorio. Es el nombre del recurso de la identidad de la empresa. Formato: accounts/{account}/businessIdentity

GetBusinessInfoRequest

Mensaje de la solicitud para el método GetBusinessInfo.

Campos
name

string

Obligatorio. Es el nombre del recurso de la información de la empresa. Formato: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Mensaje de solicitud para el método GetEmailPreferences.

Campos
name

string

Obligatorio. EmailPreferences: el nombre del recurso. Formato: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Mensaje de la solicitud para el método GetHomepage.

Campos
name

string

Obligatorio. Es el nombre de la página principal que se recuperará. Formato: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Mensaje de la solicitud para el método GetOnlineReturnPolicy.

Campos
name

string

Obligatorio. Es el nombre de la política de devoluciones que se recuperará. Formato: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Mensaje de solicitud para el método GetProgram.

Campos
name

string

Obligatorio. Es el nombre del programa que se recuperará. Formato: accounts/{account}/programs/{program}

GetRegionRequest

Mensaje de la solicitud para el método GetRegion.

Campos
name

string

Obligatorio. Es el nombre de la región que se recuperará. Formato: accounts/{account}/regions/{region}

GetShippingSettingsRequest

Mensaje de la solicitud para el método GetShippingSetting.

Campos
name

string

Obligatorio. Es el nombre de la configuración de envío que se recuperará. Formato: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Mensaje de la solicitud para el método GetTermsOfServiceAgreementState.

Campos
name

string

Obligatorio. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier} El formato del identificador es: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

Mensaje de la solicitud para el método GetTermsOfService.

Campos
name

string

Obligatorio. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: termsOfService/{version}

GetUserRequest

Mensaje de la solicitud para el método GetUser.

Campos
name

string

Obligatorio. Es el nombre del usuario que se recuperará. Formato: accounts/{account}/users/{email}

También es posible recuperar el usuario correspondiente al llamador usando me en lugar de una dirección de correo electrónico, como en accounts/{account}/users/me.

Encabezados

Es una lista no vacía de encabezados de fila o columna de una tabla. Se debe establecer exactamente uno de los siguientes valores: prices, weights, num_items, postal_code_group_names o location.

Campos
prices[]

Price

Obligatorio. Una lista de los límites superiores de precios de los pedidos inclusivos. El valor del último precio puede ser infinito si se establece price amount_micros = -1. Por ejemplo, [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] representa los encabezados "<= USD 10", "<= USD 500" y "> USD 500". Todos los precios de un servicio deben tener la misma moneda. No debe estar vacío. Debe ser positivo, excepto -1. Solo se puede configurar si no se configuran todos los demás campos.

weights[]

Weight

Obligatorio. Es una lista de límites superiores del peso del pedido inclusivo. El valor del último peso puede ser infinito si se establece price amount_micros = -1. Por ejemplo, [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] representa los encabezados "<= 10 kg", "<= 50 kg" y "> 50 kg". Todos los pesos dentro de un servicio deben tener la misma unidad. No debe estar vacío. Debe ser positivo, excepto -1. Solo se puede configurar si no se configuran todos los demás campos.

number_of_items[]

string

Obligatorio. Es una lista de los límites superiores inclusivos de la cantidad de elementos. El último valor puede ser "infinity". Por ejemplo, ["10", "50", "infinity"] representa los encabezados "<= 10 elementos", "<= 50 elementos" y "> 50 elementos". No debe estar vacío. Solo se puede configurar si no se configuran todos los demás campos.

postal_code_group_names[]

string

Obligatorio. Es una lista de nombres de grupos postales. El último valor puede ser "all other locations". Ejemplo: ["zone 1", "zone 2", "all other locations"]. Los grupos de códigos postales a los que se hace referencia deben coincidir con el país de entrega del servicio. No debe estar vacío. Solo se puede configurar si no se configuran todos los demás campos.

locations[]

LocationIdSet

Obligatorio. Es una lista de conjuntos de IDs de ubicación. No debe estar vacío. Solo se puede configurar si no se configuran todos los demás campos.

Página principal

El mensaje Homepage representa la página principal de la tienda de un comercio dentro del sistema.

La página principal de un comercio es el dominio principal en el que los clientes interactúan con su tienda.

La página principal se puede reclamar y verificar como prueba de propiedad, y permite que el comercio desbloquee funciones que requieren un sitio web verificado. Para obtener más información, consulta Información sobre la verificación de URLs de tiendas en línea.

Campos
name

string

Identificador. Es el nombre del recurso de la página principal de la tienda. Formato: accounts/{account}/homepage

claimed

bool

Solo salida. Indica si la página principal está reclamada. Consulta https://support.google.com/merchants/answer/176793.

uri

string

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

string

Obligatorio. Es la cuenta en la que se insertará este producto. Formato: accounts/{account}

shipping_setting

ShippingSettings

Obligatorio. La versión nueva de la cuenta.

ListAccountIssuesRequest

Mensaje de la solicitud para el método ListAccountIssues.

Campos
parent

string

Obligatorio. El elemento superior, que es propietario de esta colección de problemas. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de problemas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 50 usuarios. El valor máximo es 100; los valores superiores a 100 se convertirán a 100.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListAccountIssues anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListAccountIssues deben coincidir con la llamada que proporcionó el token de la página.

language_code

string

Opcional. Los problemas de la respuesta tendrán campos legibles por humanos en el idioma determinado. El formato es BCP-47, como en-US o sr-Latn. Si no se proporciona ningún valor, se usará en-US.

time_zone

string

Opcional. La zona horaria de IANA que se usa para localizar las horas en campos legibles por humanos. Por ejemplo, "America/Los_Angeles". Si no se establece, se usará "America/Los_Angeles".

ListAccountIssuesResponse

Mensaje de respuesta para el método ListAccountIssues.

Campos
account_issues[]

AccountIssue

Los problemas de la cuenta especificada.

next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListAccountsRequest

Mensaje de la solicitud para el método ListAccounts.

Campos
page_size

int32

Opcional. Es la cantidad máxima de cuentas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran como máximo 250 cuentas. El valor máximo es 500, y los valores superiores se convertirán a 500.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListAccounts anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListAccounts deben coincidir con la llamada que proporcionó el token de la página.

filter

string

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[]

Account

Las cuentas que coinciden con el ListAccountsRequest

next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListOnlineReturnPoliciesRequest

Mensaje de la solicitud para el método ListOnlineReturnPolicies.

Campos
parent

string

Obligatorio. La cuenta del comercio para la que se enumerarán las políticas de devoluciones. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de recursos OnlineReturnPolicy que se mostrarán. El servicio muestra menos que este valor si la cantidad de políticas de devoluciones del comercio determinado es menor que pageSize. El valor predeterminado es 10. El valor máximo es 100. Si se especifica un valor superior al máximo, pageSize se establecerá de forma predeterminada en el máximo.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListOnlineReturnPolicies anterior. Proporciona el token de página para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListOnlineReturnPolicies deben coincidir con la llamada que proporcionó el token de la página. Es el token que se muestra como nextPageToken en la respuesta a la solicitud anterior.

ListOnlineReturnPoliciesResponse

Mensaje de respuesta para el método ListOnlineReturnPolicies.

Campos
online_return_policies[]

OnlineReturnPolicy

Las políticas de devoluciones recuperadas

next_page_token

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListProgramsRequest

Mensaje de solicitud para el método ListPrograms.

Campos
parent

string

Obligatorio. Es el nombre de la cuenta para la que se recuperarán todos los programas. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de programas que se mostrarán en una sola respuesta. Si no se especifica (o 0), se usa un tamaño predeterminado de 1,000. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.

page_token

string

Opcional. Es un token de Continuation, recibido desde una llamada a ListPrograms anterior. Proporciona esto para recuperar la página siguiente.

ListProgramsResponse

Mensaje de respuesta para el método ListPrograms.

Campos
programs[]

Program

Los programas de la cuenta determinada.

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListRegionsRequest

Mensaje de la solicitud para el método ListRegions.

Campos
parent

string

Obligatorio. La cuenta para la que se enumerarán las regiones. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de regiones que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 50 regiones. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListRegions anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListRegions deben coincidir con la llamada que proporcionó el token de la página.

ListRegionsResponse

Mensaje de respuesta para el método ListRegions.

Campos
regions[]

Region

Las regiones del comercio especificado.

next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListSubAccountsRequest

Mensaje de la solicitud para el método ListSubAccounts.

Campos
provider

string

Obligatorio. El proveedor de servicios de agregación. Formato: providers/{providerId}

page_size

int32

Opcional. Es la cantidad máxima de cuentas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se muestran como máximo 250 cuentas. El valor máximo es 500, y los valores superiores se convertirán a 500.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListAccounts anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListAccounts deben coincidir con la llamada que proporcionó el token de la página.

ListSubAccountsResponse

Mensaje de respuesta para el método ListSubAccounts.

Campos
accounts[]

Account

Las cuentas para las que la cuenta parental determinada es un agregador

next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

ListUsersRequest

Mensaje de la solicitud para el método ListUsers.

Campos
parent

string

Obligatorio. El elemento superior, que es propietario de esta colección de usuarios. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de usuarios que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 50 usuarios. El valor máximo es 100; los valores superiores a 100 se convertirán a 100.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListUsers anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListUsers deben coincidir con la llamada que proporcionó el token de la página.

ListUsersResponse

Mensaje de respuesta para el método ListUsers.

Campos
users[]

User

Los usuarios de la cuenta especificada.

next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

LocationIdSet

Es una lista de conjuntos de IDs de ubicación. No debe estar vacío. Solo se puede configurar si no se configuran todos los demás campos.

Campos
location_ids[]

string

Obligatorio. Es una lista no vacía de IDs de ubicación. Todos deben ser del mismo tipo de ubicación (por ejemplo, estado).

MinimumOrderValueTable

Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro.

Campos
store_code_set_with_movs[]

StoreCodeSetWithMov

Obligatorio. Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del pedido (MOV). Se requieren al menos dos conjuntos, y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda.

StoreCodeSetWithMov

Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del pedido. Se requieren al menos dos conjuntos, y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda.

Campos
store_codes[]

string

Opcional. Es una lista de códigos de tienda únicos o vacía para la opción de todo.

value

Price

Es el valor mínimo del pedido para las tiendas determinadas.

OnlineReturnPolicy

Objeto Online return policy. Actualmente, se usa para representar las políticas de devoluciones de los programas de anuncios y fichas gratuitas.

Campos
name

string

Identificador. OnlineReturnPolicy: el nombre del recurso. Formato: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

Solo salida. Es el ID de la política de devoluciones que genera Google.

label

string

Obligatorio. Inmutable. Este campo representa la etiqueta única definida por el usuario de la política de devoluciones. Es importante tener en cuenta que no se puede usar la misma etiqueta en diferentes políticas de devoluciones para el mismo país. A menos que un producto especifique un atributo de etiqueta específico, las políticas se etiquetarán automáticamente como "predeterminadas". Para asignar una política de devoluciones personalizada a ciertos grupos de productos, sigue las instrucciones que se proporcionan en la Etiqueta de la política de devoluciones. La etiqueta puede contener hasta 50 caracteres.

countries[]

string

Obligatorio. Inmutable. Los países de venta en los que se aplica la política de devoluciones Los valores deben ser un código ISO 3166 de 2 letras válido.

policy

Policy

La política de devoluciones.

seasonal_overrides[]

SeasonalOverride

Opcional. Son anulaciones de la política general para los pedidos realizados durante un conjunto específico de intervalos de tiempo.

restocking_fee

RestockingFee

La tarifa de reposición que se aplica a todas las categorías de motivos de devolución. Si no se establece el valor, se considerará una tarifa de reabastecimiento sin costo.

return_methods[]

ReturnMethod

Son los métodos de devolución que pueden usar los clientes para devolver un artículo. Este valor debe ser no vacío, a menos que el tipo de política de devoluciones sea noReturns.

item_conditions[]

ItemCondition

Las condiciones de los artículos aceptadas para las devoluciones no deben estar vacías, a menos que el tipo de política de devoluciones sea "noReturns".

return_shipping_fee

ReturnShippingFee

La tarifa de envío por devolución. Se debe establecer solo cuando el cliente necesita descargar e imprimir la etiqueta de devolución.

return_policy_uri

string

Obligatorio. Es el URI de la política de devoluciones. Google puede usar esto para realizar una verificación de la política. Debe ser una URL válida.

accept_defective_only

bool

Este campo es obligatorio y especifica si el comercio solo acepta productos defectuosos para las devoluciones.

process_refund_days

int32

El campo especifica la cantidad de días que tardan los comercios en procesar los reembolsos. Es opcional.

accept_exchange

bool

Este campo es obligatorio y especifica si el comercio permite que los clientes intercambien productos.

ItemCondition

Las condiciones disponibles del artículo

Enumeraciones
ITEM_CONDITION_UNSPECIFIED Valor predeterminado Este valor no se usa.
NEW Nueva.
USED Usado.

Política

Las políticas disponibles

Campos
type

Type

Tipo de política.

days

int64

Es la cantidad de días durante los que se pueden devolver los artículos después de la entrega, donde un día se define como 24 horas después de la marca de tiempo de entrega. Obligatorio para las devoluciones de NUMBER_OF_DAYS_AFTER_DELIVERY.

Tipo

Tipos de políticas de devoluciones.

Enumeraciones
TYPE_UNSPECIFIED Valor predeterminado Este valor no se usa.
NUMBER_OF_DAYS_AFTER_DELIVERY Es la cantidad de días durante los cuales una devolución es válida después de la entrega.
NO_RETURNS No ofrece devoluciones.
LIFETIME_RETURNS Devoluciones ilimitadas.

RestockingFee

La tarifa de reposición. Puede ser una tarifa fija o un microporcentaje.

Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

fixed_fee

Price

Tarifa de reposición fija.

micro_percent

int32

Es el porcentaje del precio total en micros. 15,000,000 significa que se cobraría el 15% del precio total.

ReturnMethod

Los métodos de devolución disponibles.

Enumeraciones
RETURN_METHOD_UNSPECIFIED Valor predeterminado Este valor no se usa.
BY_MAIL Devolución por correo
IN_STORE Devolución en tienda
AT_A_KIOSK Devolución en un kiosco

ReturnShippingFee

La tarifa de envío por devolución. Puede ser una tarifa fija o un valor booleano para indicar que el cliente paga el costo de envío real.

Campos
type

Type

Obligatorio. Es el tipo de tarifa de envío por devolución.

fixed_fee

Price

Es el importe fijo de la tarifa de envío por devolución. Este valor solo se aplica cuando el tipo es FIXED. Consideraremos que la tarifa de envío de devolución es gratuita si el tipo es FIXED y no se establece este valor.

Tipo

Tipos de tarifas de envío por devolución.

Enumeraciones
TYPE_UNSPECIFIED Valor predeterminado Este valor no se usa.
FIXED La tarifa de envío por devolución es un valor fijo.
CUSTOMER_PAYING_ACTUAL_FEE Los clientes pagarán la tarifa real del envío por devolución.

SeasonalOverride

Siguiente: 5

Campos
label

string

Obligatorio. Es el nombre visible de esta anulación de temporada en Merchant Center.

begin

Date

Obligatorio. Define el período en el que se aplica esta excepción de temporada. Tanto el inicio como el final son inclusivos y deben estar en formato decimal de fecha, por ejemplo, 20250115. Las fechas de las excepciones de temporada no deben superponerse.

end

Date

Obligatorio. Es la fecha de finalización de la excepción de temporada (inclusive).

policy

Policy

Obligatorio. Es la política de devoluciones del período determinado.

PhoneVerificationState

El estado de verificación del teléfono.

Enumeraciones
PHONE_VERIFICATION_STATE_UNSPECIFIED Valor predeterminado Este valor no se usa.
PHONE_VERIFICATION_STATE_VERIFIED Se verificó el teléfono.
PHONE_VERIFICATION_STATE_UNVERIFIED El teléfono no está verificado

Programa

Define la participación en un programa determinado para la cuenta especificada.

Los programas proporcionan un mecanismo para agregar funciones a las cuentas de comerciante. Un ejemplo típico de esto es el programa de fichas de productos gratuitas, que permite que los productos de la tienda de un comercio se muestren en Google de forma gratuita.

Campos
name

string

Identificador. Es el nombre del recurso del programa. Formato: accounts/{account}/programs/{program}

documentation_uri

string

Solo salida. Es la URL de una página de ayuda de Merchant Center en la que se describe el programa.

state

State

Solo salida. Es el estado de participación de la cuenta en el programa.

active_region_codes[]

string

Solo salida. Las regiones en las que la cuenta participa activamente en el programa Las regiones activas se definen como aquellas en las que se cumplen todos los requisitos del programa que las afectan.

Los códigos de región se definen en CLDR. Es un país en el que el programa se aplica específicamente o 001 cuando el programa se aplica a nivel global.

unmet_requirements[]

Requirement

Solo salida. Los requisitos que la cuenta aún no cumple y que afectan la participación en el programa

Requisito

Define un requisito especificado para participar en el programa.

Campos
title

string

Solo salida. Es el nombre del requisito.

documentation_uri

string

Solo salida. Es la URL de una página de ayuda en la que se describe el requisito.

affected_region_codes[]

string

Solo salida. Las regiones que actualmente se ven afectadas por el incumplimiento de este requisito

Los códigos de región se definen en CLDR. Es un país en el que el programa se aplica específicamente o 001 cuando el programa se aplica a nivel global.

Estado

Son los posibles estados de participación en el programa de la cuenta.

Enumeraciones
STATE_UNSPECIFIED Valor predeterminado Este valor no se usa.
NOT_ELIGIBLE La cuenta no es apta para participar en el programa.
ELIGIBLE La cuenta es apta para participar en el programa.
ENABLED El programa está habilitado para la cuenta.

RateGroup

Definiciones de grupos de tarifas de envío Solo el último puede tener un applicable_shipping_labels vacío, lo que significa "todo lo demás". El otro applicable_shipping_labels no debe superponerse.

Campos
applicable_shipping_labels[]

string

Obligatorio. Es una lista de etiquetas de envío que definen los productos a los que se aplica este grupo de tarifas. Esta es una disyunción: solo una de las etiquetas debe coincidir para que se aplique el grupo de tarifas. Solo puede estar vacío para el último grupo de tarifas de un servicio.

subtables[]

Table

Opcional. Es una lista de tablas secundarias a las que hace referencia main_table. Solo se puede configurar si se establece main_table.

carrier_rates[]

CarrierRate

Opcional. Es una lista de tarifas de operadores a las que se puede hacer referencia con main_table o single_value.

single_value

Value

Es el valor del grupo de tarifas (por ejemplo, tarifa plana de USD 10). Solo se puede configurar si no se establecen main_table y subtables.

main_table

Table

Una tabla que define el grupo de tarifas, cuando single_value no es lo suficientemente expresivo. Solo se puede configurar si no se configuró single_value.

name

string

Opcional. Es el nombre del grupo de tarifas. Si se establece, debe ser único dentro del servicio de envío.

Región

Representa una región geográfica que puedes usar como objetivo con los servicios RegionalInventory y ShippingSettings. Puedes definir las regiones como colecciones de códigos postales o, en algunos países, con geosegmentaciones predefinidas. Para obtener más información, consulta Configura regiones .

Campos
name

string

Identificador. Es el nombre del recurso de la región. Formato: accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

Opcional. Es una lista de códigos postales que define el área de la región.

geotarget_area

GeoTargetArea

Opcional. Es una lista de geosegmentaciones que define el área de la región.

regional_inventory_eligible

BoolValue

Solo salida. Indica si la región es apta para usarse en la configuración del inventario regional.

shipping_eligible

BoolValue

Solo salida. Indica si la región es apta para usarse en la configuración de los servicios de envío.

display_name

string

Opcional. Es el nombre visible de la región.

GeoTargetArea

Es una lista de geosegmentaciones que define el área de la región.

Campos
geotarget_criteria_ids[]

int64

Obligatorio. Es una lista no vacía de IDs de ubicación. Todos deben ser del mismo tipo de ubicación (por ejemplo, estado).

PostalCodeArea

Es una lista de códigos postales que define el área de la región. Nota: Se puede acceder a todas las regiones definidas con códigos postales a través del recurso ShippingSettings.postalCodeGroups de la cuenta.

Campos
region_code

string

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[]

PostalCodeRange

Obligatorio. Es un intervalo de códigos postales.

PostalCodeRange

Es un rango de códigos postales que define el área de la región.

Campos
begin

string

Obligatorio. Un código postal o un patrón del formato prefijo* que indica el límite inferior inclusivo del rango que define el área. Valores de ejemplo: 94108, 9410*, 9*.

end

string

Opcional. Un código postal o un patrón del tipo prefix* que indica el límite superior inclusivo del rango que define el área. Debe tener la misma longitud que postalCodeRangeBegin: si postalCodeRangeBegin es un código postal, postalCodeRangeEnd también debe ser un código postal. Si postalCodeRangeBegin es un patrón, postalCodeRangeEnd también debe ser un patrón con la misma longitud de prefijo. Opcional: Si no se establece, el área se define como todos los códigos postales que coinciden con postalCodeRangeBegin.

Obligatorio

Describe las condiciones del servicio que se deben aceptar.

Campos
terms_of_service

string

Los termsOfService que se deben aceptar.

tos_file_uri

string

Es la URL completa del archivo de las Condiciones del Servicio. Este campo es el mismo que TermsOfService.file_uri y se agrega aquí solo por conveniencia.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

Mensaje de la solicitud para el método RetrieveForApplicationTermsOfServiceAgreementState.

Campos
parent

string

Obligatorio. La cuenta para la que se debe obtener un formato TermsOfServiceAgreementState: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Mensaje de la solicitud para el método RetrieveLatestTermsOfService.

Campos
region_code

string

Obligatorio. Es el código de región según se define en CLDR. Es un país cuando las Condiciones del Servicio se aplican específicamente a ese país o 001 cuando se aplican a nivel global.

kind

TermsOfServiceKind

Obligatorio. El tipo al que se aplica esta versión de las Condiciones del Servicio.

Fila

Incluye una lista de celdas.

Campos
cells[]

Value

Obligatorio. Es la lista de celdas que conforman la fila. Debe tener la misma longitud que columnHeaders para tablas de dos dimensiones y una longitud de 1 para tablas de una dimensión.

Servicio

Servicio de envío

Campos
delivery_countries[]

string

Obligatorio. Es el código de territorio de CLDR de los países a los que se aplica el servicio.

rate_groups[]

RateGroup

Opcional. Definiciones de grupos de tarifas de envío Solo el último puede tener un applicable_shipping_labels vacío, lo que significa "todo lo demás". El otro applicable_shipping_labels no debe superponerse.

loyalty_programs[]

LoyaltyProgram

Opcional. Son los programas de lealtad a los que se limita este servicio de envío.

service_name

string

Obligatorio. Es el nombre del servicio de formato libre. Debe ser único en la cuenta de destino.

active

bool

Obligatorio. Es un valor booleano que expone el estado activo del servicio de envío.

currency_code

string

Es el código CLDR de la moneda a la que se aplica este servicio. Debe coincidir con el de los precios de los grupos de tarifas.

delivery_time

DeliveryTime

Obligatorio. Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.

shipment_type

ShipmentType

Es el tipo de ubicaciones a las que este servicio envía pedidos.

minimum_order_value

Price

Es el valor mínimo del pedido para este servicio. Si se establece, indica que los clientes deberán gastar, al menos, este importe. Todos los precios de un servicio deben tener la misma moneda. No se puede establecer junto con minimum_order_value_table.

minimum_order_value_table

MinimumOrderValueTable

Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro. No se puede establecer junto con minimum_order_value.

store_config

StoreConfig

Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local.

LoyaltyProgram

Programa de lealtad proporcionado por un comercio.

Campos
loyalty_program_tiers[]

LoyaltyProgramTiers

Opcional. Es el nivel del programa de lealtad de este servicio de envío.

program_label

string

Es la etiqueta del programa de lealtad establecida en la configuración de tu programa de lealtad en Merchant Center. Este atributo secundario permite que Google asigne tu programa de lealtad a las ofertas aptas.

LoyaltyProgramTiers

Es un subconjunto de un programa de lealtad de comercios.

Campos
tier_label

string

El atributo secundario etiqueta de nivel [tier_label] diferencia los beneficios del nivel de oferta entre cada nivel. Este valor también se establece en la configuración del programa en Merchant Center y es obligatorio para hacer cambios en la fuente de datos, incluso si tu programa de lealtad solo tiene 1 nivel.

ShipmentType

Es el tipo de envío del servicio de envío.

Enumeraciones
SHIPMENT_TYPE_UNSPECIFIED Este servicio no especificó el tipo de envío.
DELIVERY Con este servicio, se envían los pedidos a una dirección que elige el cliente.
LOCAL_DELIVERY Con este servicio, se envían los pedidos a una dirección que elige el cliente. El pedido se envía desde una tienda local cercana.
COLLECTION_POINT Con este servicio, se envían los pedidos a una dirección que elige el cliente. El pedido se envía desde un punto de recolección.

StoreConfig

Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local.

Campos
store_codes[]

string

Opcional. Es una lista de códigos de tienda que proporcionan entrega local. Si está vacío, all_stores debe ser verdadero.

store_service_type

StoreServiceType

Indica si todas las tiendas, o las seleccionadas, que figuran en la ficha de este comercio ofrecen entrega local.

cutoff_config

CutoffConfig

Las configuraciones relacionadas con la entrega local finalizan por el día.

service_radius

Distance

Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local.

CutoffConfig

Las configuraciones relacionadas con la entrega local finalizan por el día.

Campos
local_cutoff_time

LocalCutoffTime

Hora en la que finaliza la entrega local del día.

store_close_offset_hours

int64

Solo es válido con la entrega local. Representa la hora límite como la cantidad de horas antes del cierre de la tienda. Este campo y local_cutoff_time son mutuamente excluyentes.

no_delivery_post_cutoff

bool

Los comercios pueden inhabilitar la opción de mostrar la entrega local en n+1 días cuando tienen un servicio de envío configurado para la entrega local en n días. Por ejemplo, si el servicio de envío define la entrega el mismo día y ya pasó la hora límite, configurar este campo en true hará que la tarifa del servicio de envío calculada muestre NO_DELIVERY_POST_CUTOFF. En el mismo ejemplo, si configuras este campo como false, el tiempo de envío calculado será de un día. Esto es solo para la entrega local.

LocalCutoffTime

Hora en la que finaliza la entrega local del día.

Campos
hour

int64

Hora límite para realizar pedidos de entrega local para que se procesen el mismo día.

minute

int64

Los pedidos de entrega local en minutos deben realizarse antes de esta hora para que se procesen el mismo día.

StoreServiceType

Indica si todas las tiendas, o las seleccionadas, que enumera el comercio ofrecen entrega local.

Enumeraciones
STORE_SERVICE_TYPE_UNSPECIFIED No se especificó el tipo de servicio de la tienda.
ALL_STORES Indica si todas las tiendas, actuales y futuras, que enumera este comercio ofrecen entrega local.
SELECTED_STORES Indica que solo las tiendas que se indican en store_codes son aptas para la entrega local.

ShippingSettings

La configuración de envío de la cuenta de comerciante

Campos
name

string

Identificador. Es el nombre del recurso de la configuración de envío. Formato: accounts/{account}/shippingSetting

services[]

Service

Opcional. La lista de servicios de la cuenta de destino

warehouses[]

Warehouse

Opcional. Es una lista de almacenes a los que se puede hacer referencia en services.

etag

string

Obligatorio. Este campo se usa para evitar problemas asíncronos. Asegúrate de que los datos de configuración de envío no hayan cambiado entre la llamada de Get y la llamada de Insert. El usuario debe seguir los siguientes pasos:

  1. Establece el campo de etiqueta como una cadena vacía para la creación inicial de la configuración de envío.

  2. Después de la creación inicial, llama al método get para obtener una etiqueta de metadatos y los datos de configuración de envío actuales antes de llamar a insert.

  3. Modifica la información de configuración de envío que quieras.

  4. Llama al método insert con la información de configuración de envío deseada con la etiqueta de inserción obtenida en el paso 2.

  5. Si los datos de configuración de envío cambiaron entre el paso 2 y el paso 4. La solicitud de inserción fallará porque la etiqueta de metadatos cambia cada vez que cambian los datos de la configuración de envío. El usuario debe repetir los pasos 2 a 4 con la nueva etiqueta.

Tabla

Una tabla que define el grupo de tarifas, cuando single_value no es lo suficientemente expresivo.

Campos
rows[]

Row

Obligatorio. Es la lista de filas que conforman la tabla. Debe tener la misma longitud que row_headers.

name

string

Es el nombre de la tabla. Es obligatorio para las tablas secundarias y se ignora para la tabla principal.

row_headers

Headers

Obligatorio. Encabezados de las filas de la tabla.

column_headers

Headers

Encabezados de las columnas de la tabla. Opcional: Si no se establece, la tabla solo tiene una dimensión.

TermsOfService

El mensaje TermsOfService representa una versión específica de las condiciones del servicio que los comercios deben aceptar para acceder a ciertas funciones o servicios (consulta https://support.google.com/merchants/answer/160173).

Este mensaje es importante para el proceso de integración, ya que garantiza que los comercios acepten los acuerdos legales necesarios para usar el servicio. Los comercios pueden recuperar las condiciones del servicio más recientes para un kind y region determinados a través de RetrieveLatestTermsOfService y aceptarlas según sea necesario a través de AcceptTermsOfService.

Campos
name

string

Identificador. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: termsOfService/{version}

region_code

string

Es el código de región según se define en CLDR. Es un país en el que las Condiciones del Servicio se aplican específicamente a ese país o 001 cuando se puede firmar el mismo TermsOfService en cualquier país. Sin embargo, ten en cuenta que, cuando se firma una CGU que se aplica a nivel global, se espera que se proporcione un país específico (debe ser el país de la empresa del comercio o el país de participación en el programa).

kind

TermsOfServiceKind

El tipo al que se aplica esta versión de las Condiciones del Servicio.

external

bool

Indica si esta versión de las Condiciones del Servicio es externa. Las versiones externas de las Condiciones del Servicio solo se pueden acordar a través de procesos externos y no directamente por parte del comercio a través de la IU o la API.

file_uri

string

Es el URI del archivo de condiciones del servicio que se debe mostrar a los usuarios que firman.

TermsOfServiceAgreementState

Este recurso representa el estado del acuerdo de una cuenta y un tipo de condiciones del servicio determinados. El estado es el siguiente:

  • Si el comercio aceptó las condiciones del servicio, se propagará accepted; de lo contrario, estará vacío.
  • Si el comercio debe firmar las condiciones del servicio, se propagará obligatorio; de lo contrario, estará vacío.

Ten en cuenta que pueden estar presentes los valores required y accepted. En este caso, las condiciones del servicio de accepted tendrán una fecha de vencimiento establecida en el campo valid_until. Las condiciones del servicio de required deben aceptarse antes de valid_until para que la cuenta siga teniendo un acuerdo válido. Cuando se aceptan nuevas condiciones del servicio, esperamos que los terceros muestren el texto asociado con el acuerdo de condiciones del servicio determinado (la URL del archivo que contiene el texto se agrega en el mensaje obligatorio que aparece a continuación como tos_file_uri). Para aceptar las condiciones del servicio, llama a accept en el recurso TermsOfService.

Campos
name

string

Identificador. Es el nombre del recurso de la versión de las condiciones del servicio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier} El formato del identificador es: {TermsOfServiceKind}-{country} Por ejemplo, un identificador podría ser: MERCHANT_CENTER-US

region_code

string

Código de región según se define en https://cldr.unicode.org/. Es el país al que se aplica el estado actual.

terms_of_service_kind

TermsOfServiceKind

Es el tipo de Condiciones del Servicio asociadas con la versión en particular.

accepted

Accepted

Las condiciones del servicio aceptadas de este tipo y para el region_code asociado

required

Required

Las Condiciones del Servicio requeridas

TermsOfServiceKind

El tipo TermsOfService.

Enumeraciones
TERMS_OF_SERVICE_KIND_UNSPECIFIED Valor predeterminado Este valor no se usa.
MERCHANT_CENTER Aplicación de Merchant Center.

TransitTable

Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de filas y columnas Se puede configurar min_transit_days, max_transit_days o transit_time_table, pero no ambos.

Campos
postal_code_group_names[]

string

Obligatorio. Es una lista de nombres de regiones Region.name . El último valor puede ser "all other locations". Ejemplo: ["zone 1", "zone 2", "all other locations"]. Los grupos de códigos postales a los que se hace referencia deben coincidir con el país de entrega del servicio.

transit_time_labels[]

string

Obligatorio. Es una lista de etiquetas de tiempo en tránsito. El último valor puede ser "all other labels". Ejemplo: ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

Obligatorio. Si solo hay un conjunto de dimensiones de postal_code_group_names o transit_time_labels, hay varias filas, cada una con un valor para esa dimensión. Si hay dos dimensiones, cada fila corresponde a un postal_code_group_names y las columnas (valores) a un transit_time_labels.

TransitTimeRow

Si solo hay un conjunto de dimensiones de postal_code_group_names o transit_time_labels, hay varias filas, cada una con un valor para esa dimensión. Si hay dos dimensiones, cada fila corresponde a un postal_code_group_names y las columnas (valores) a un transit_time_labels.

Campos
values[]

TransitTimeValue

Obligatorio. Es el intervalo de tiempo en tránsito (mínimo y máximo) en días hábiles.

TransitTimeValue

Es el intervalo de tiempo en tránsito (mínimo-máximo) en días hábiles.

Campos
min_transit_days

int32

Es el intervalo mínimo del tiempo en tránsito en días hábiles. 0 significa entrega el mismo día y 1 significa entrega al día siguiente.

max_transit_days

int32

Debe ser mayor o igual que min_transit_days.

UnclaimHomepageRequest

Mensaje de la solicitud para el método UnclaimHomepage.

Campos
name

string

Obligatorio. Es el nombre de la página principal que se dejará de reclamar. Formato: accounts/{account}/homepage

UpdateAccountRequest

Mensaje de la solicitud para el método UpdateAccount.

Campos
account

Account

Obligatorio. La versión nueva de la cuenta.

update_mask

FieldMask

Opcional. Es la lista de campos que se actualizarán.

Se admiten los siguientes campos (en snake_case y lowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

Mensaje de la solicitud para el método UpdateAutofeedSettings.

Campos
autofeed_settings

AutofeedSettings

Obligatorio. La nueva versión de la configuración del feed automático

update_mask

FieldMask

Obligatorio. Es la lista de campos que se actualizarán.

UpdateBusinessIdentityRequest

Mensaje de la solicitud para el método UpdateBusinessIdentity.

Campos
business_identity

BusinessIdentity

Obligatorio. Es la nueva versión de la identidad de la empresa.

update_mask

FieldMask

Opcional. Es la lista de campos que se actualizarán.

Se admiten los siguientes campos (en snake_case y lowerCamelCase):

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

UpdateBusinessInfoRequest

Mensaje de la solicitud para el método UpdateBusinessInfo.

Campos
business_info

BusinessInfo

Obligatorio. La nueva versión de la información de la empresa.

update_mask

FieldMask

Opcional. Es la lista de campos que se actualizarán.

Se admiten los siguientes campos (en snake_case y lowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

Mensaje de solicitud para el método UpdateEmailPreferences.

Campos
email_preferences

EmailPreferences

Obligatorio. Se actualizarán las preferencias de correo electrónico.

update_mask

FieldMask

Obligatorio. Es la lista de campos que se actualizarán.

Se admiten los siguientes campos (en snake_case y lowerCamelCase):

  • news_and_tips

UpdateHomepageRequest

Mensaje de la solicitud para el método UpdateHomepage.

Campos
homepage

Homepage

Obligatorio. La nueva versión de la página principal.

update_mask

FieldMask

Opcional. Es la lista de campos que se actualizarán.

Se admiten los siguientes campos (en snake_case y lowerCamelCase):

  • uri

UpdateRegionRequest

Mensaje de la solicitud para el método UpdateRegion.

Campos
region

Region

Obligatorio. La región actualizada.

update_mask

FieldMask

Opcional. Es la máscara de campo separada por comas que indica los campos que se actualizarán. Ejemplo: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

Mensaje de la solicitud para el método UpdateUser.

Campos
user

User

Obligatorio. Es la versión nueva del usuario.

Usa me para hacer referencia a tu propia dirección de correo electrónico, por ejemplo, accounts/{account}/users/me.

update_mask

FieldMask

Opcional. Es la lista de campos que se actualizarán.

Se admiten los siguientes campos (en snake_case y lowerCamelCase):

  • access_rights

Usuario

El mensaje User representa a un usuario asociado con una cuenta de Merchant Center. Se usa para administrar los permisos de usuario y los derechos de acceso dentro de la cuenta. Para obtener más información, consulta las Preguntas frecuentes sobre las personas y los niveles de acceso.

Campos
name

string

Identificador. Es el nombre del recurso del usuario. Formato: accounts/{account}/user/{email}

Usa me para hacer referencia a tu propia dirección de correo electrónico, por ejemplo, accounts/{account}/users/me.

state

State

Solo salida. Es el estado del usuario.

access_rights[]

AccessRight

Opcional. Los derechos de acceso que tiene el usuario.

Estado

Son los estados posibles de un usuario.

Enumeraciones
STATE_UNSPECIFIED Valor predeterminado Este valor no se usa.
PENDING El usuario está pendiente de confirmación. En este estado, el usuario primero debe aceptar la invitación antes de realizar otras acciones.
VERIFIED Se verificó al usuario.

Valor

Es el valor único de un grupo de tarifas o el valor de la celda de una tabla de grupos de tarifas. Se debe establecer exactamente uno de los siguientes valores: no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name.

Campos
no_shipping

bool

Si es verdadero, el producto no se puede enviar. Debe ser verdadero cuando se establece y solo se puede establecer si no se establecieron todos los demás campos.

flat_rate

Price

Una tarifa plana. Solo se puede configurar si no se configuran todos los demás campos.

price_percentage

string

Es un porcentaje del precio representado como un número en notación decimal (por ejemplo, "5.4"). Solo se puede establecer si no se establecieron todos los demás campos.

carrier_rate

string

Es el nombre de una tarifa de la empresa de transporte que hace referencia a una tarifa de la empresa de transporte definida en el mismo grupo de tarifas. Solo se puede configurar si no se configuran todos los demás campos.

subtable

string

Es el nombre de una tabla secundaria. Solo se puede establecer en celdas de tabla (por ejemplo, no para valores individuales) y solo si no se configuran todos los demás campos.

Almacén

Un almacén de distribución, que almacena y controla el inventario.

Campos
name

string

Obligatorio. El nombre del almacén Debe ser único en la cuenta.

shipping_address

Address

Obligatorio. Es la dirección de envío del almacén.

cutoff_time

WarehouseCutoffTime

Obligatorio. Es la hora del día más tarde a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén.

handling_days

int64

Obligatorio. Es la cantidad de días que tarda este almacén en empacar y enviar un artículo. Esto se aplica a nivel del almacén, pero se puede anular a nivel de la oferta según los atributos de un artículo.

business_day_config

BusinessDayConfig

Son los días hábiles del almacén. Si no se establece, será de lunes a viernes de forma predeterminada.

WarehouseBasedDeliveryTime

Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se establece, no se debe establecer ningún otro campo relacionado con el tiempo de tránsito en delivery_time.

Campos
carrier

string

Obligatorio. Operador, como "UPS" o "Fedex" operadores compatibles

carrier_service

string

Obligatorio. Servicio de operador, como "ground" o "2 days" El nombre del servicio debe estar en la lista eddSupportedServices.

warehouse

string

Obligatorio. Es el nombre del almacén. Debe coincidir con [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

Es la hora del día más tarde a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén.

Campos
hour

int32

Obligatorio. Es la hora del horario límite hasta la que se debe realizar un pedido para que el almacén lo procese el mismo día. La hora se basa en la zona horaria del almacén.

minute

int32

Obligatorio. Es el minuto del horario límite hasta el que se debe realizar un pedido para que el almacén lo procese el mismo día. El minuto se basa en la zona horaria del almacén.