Programa transferencias de Merchant Center

Vista previa

Este producto está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos de la fase previa a la DG están disponibles "sin modificaciones" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Para obtener asistencia o proporcionar comentarios sobre las transferencias de Merchant Center con el Servicio de transferencia de datos de BigQuery, comunícate con [e-mail].

Antes de comenzar

Antes de crear una transferencia de datos de Merchant Center, haz lo siguiente:

• Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery
• Crea un conjunto de datos de BigQuery para almacenar los datos de Merchant Center.
  • Para la región del conjunto de datos, admitimos el uso de la opción predeterminada, multirregión, en US o EU.
  • Si deseas crear un conjunto de datos en una región específica, la transferencia de datos de Merchant Center solo se admite en las siguientes regiones:
  • us-east4 (Northern Virginia),
  • asia-northeast1 (Tokyo)
  • asia-southeast1 (Singapore)
  • australia-southeast1 (Sydney)
  • europe-north1 (Finland)
  • europe-west2 (London)
  • europe-west6 (Zurich).
• Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Permisos necesarios

Asegúrate de haber otorgado los siguientes permisos.

Roles de BigQuery requeridos

Para obtener los permisos que necesitas para crear una transferencia de datos de Servicio de transferencia de datos de BigQuery, pídele a tu administrador que te otorgue el rol de IAM de administrador de BigQuery (roles/bigquery.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery:

• Permisos del Servicio de transferencia de datos de BigQuery:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Permisos de BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información, consulta Cómo otorgar acceso a bigquery.admin.

Roles obligatorios de Merchant Center

• Acceso estándar a la cuenta de Merchant Center que se usa en la configuración de la transferencia. Si configuras una transferencia con una cuenta de servicio, la cuenta de servicio debe tener acceso a la cuenta de Merchant Center. Para verificar el acceso, haz clic en la sección Usuarios de la IU de Merchant Center.

• Para acceder a los datos de competitividad de precios, estadísticas de precios y los más vendidos, debes cumplir con los requisitos de elegibilidad para las estadísticas de mercado.

Configura una transferencia de Merchant Center

La configuración de una transferencia de datos para los informes de Merchant Center requiere lo siguiente:

• ID de Merchant Center o ID de cuenta de varios clientes: Es el ID de Merchant Center que aparece en la IU de Merchant Center.

Sigue estos pasos para crear una transferencia de datos para los informes de Merchant Center:

Console

1. Ve a la página Transferencia de datos en la Google Cloud consola.

   Ir a Transferencias de datos

2. Haz clic en Crear transferencia.

3. En la página Crear transferencia, sigue estos pasos:

   • En la sección Tipo de fuente, en Fuente, elige Google Merchant Center.

   • En la sección Nombre de la configuración de transferencia, en Nombre visible, ingresa el nombre de la transferencia de datos, como My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificarla si necesitas modificarla más adelante.

     

   • En la sección Opciones de programación, haz lo siguiente:

     • Selecciona una opción en Frecuencia de repetición. Si seleccionas Horas, Días, Semanas o Meses, también debes especificar una frecuencia. También puedes seleccionar Personalizado para especificar una frecuencia de repetición personalizada. Si seleccionas Según demanda, esta transferencia de datos se ejecuta cuando activas la transferencia de forma manual.
     • Si corresponde, selecciona Comenzar ahora o Comenzar a la hora definida y detalla una fecha de inicio y una hora de ejecución.
     • En Fecha de inicio y hora de ejecución, ingresa la fecha y la hora para iniciar la transferencia. Este valor debe ser al menos 24 horas después del horario UTC actual. Si elegiste Comenzar ahora, esta opción estará inhabilitada.

     Si dejas las opciones de programación configuradas como Comenzar ahora, la primera ejecución de transferencia de datos se iniciará de inmediato, fallará y mostrará el siguiente mensaje de error: No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer. La próxima ejecución programada debería ejecutarse de forma correcta. Si los datos de tu cuenta de Merchant se prepararon con la misma fecha en horario UTC, puedes configurar un reabastecimiento para la ejecución de hoy.

     

   • En la sección Configuración de destino, en Conjunto de datos de destino, elige el conjunto de datos que creaste para almacenar tus datos.

     

   • En la sección Detalles de la fuente de datos, en ID de Merchant Center, ingresa tu ID de Merchant Center o ID de MCA. Selecciona los informes que quieres transferir. Consulta Informes compatibles para obtener más detalles.

     

   • En el menú Cuenta de servicio, selecciona una cuenta de servicio de aquellas que están asociadas con tuGoogle Cloud proyecto. Puedes asociar una cuenta de servicio con tu transferencia de datos en lugar de usar tus credenciales de usuario. Para obtener más información sobre cómo usar cuentas de servicio con transferencias de datos, consulta Usa cuentas de servicio.

     • Si accediste con una identidad federada, se requiere una cuenta de servicio para crear una transferencia de datos. Si accediste con una Cuenta de Google, la cuenta de servicio para la transferencia es opcional.
     • La cuenta de servicio debe tener los permisos necesarios.

   • De forma opcional, en la sección Opciones de notificación, haz lo siguiente:

     • Haz clic en el botón de activación para habilitar las notificaciones por correo electrónico. Si habilitas esta opción, el administrador de transferencias recibirá una notificación por correo electrónico cuando falle la ejecución de una transferencia.
     • En Selecciona un tema de Pub/Sub, elige el nombre de tu tema o haz clic en Crear un tema. Con esta opción, se configuran las notificaciones de ejecución de Pub/Sub para tu transferencia.

4. Haz clic en Guardar.

bq

Ingresa el comando bq mk y suministra la marca de creación de transferencias --transfer_config. También se requieren las siguientes marcas:

• --data_source
• --target_dataset
• --display_name
• --params

También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si no se especifica --project_id, se usa el proyecto predeterminado.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source
--service_account_name=service_account_name

Donde:

• project_id es el ID del proyecto.
• dataset es el conjunto de datos de destino para la configuración de la transferencia.
• name es el nombre visible de la configuración de transferencia. El nombre de la transferencia puede ser cualquier valor que te permita identificarla si es necesario hacerle modificaciones más tarde.
• parameters contiene los parámetros para la configuración de la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'
  • Para las transferencias de datos de Merchant Center, debes proporcionar el parámetro merchant_id.
  • El parámetro export_products especifica si se deben transferir los datos de productos y problemas de productos. Este parámetro se incluye de forma predeterminada, incluso si no especificas el parámetro export_products. Google recomienda incluir este parámetro de forma explícita y configurarlo como “true”.
  • El parámetro export_regional_inventories especifica si se deben transferir los datos de inventarios regionales.
  • El parámetro export_local_inventories especifica si se deben transferir los datos de inventarios locales.
  • El parámetro export_price_competitiveness especifica si se transfieren datos de comparativa de precios.
  • El parámetro export_price_insights especifica si se transfieren datos de comparativa de precios.
  • El parámetro export_best_sellers_v2 especifica si se deben transferir los datos de los más vendidos.
  • El parámetro export_performance especifica si se deben transferir los datos de rendimiento del producto.
• data_source es la fuente de datos: merchant_center.
• service_account_name es el nombre de la cuenta de servicio que se usa para autenticar tu transferencia de datos. La cuenta de servicio debe ser propiedad del mismo project_id que se usa para crear la transferencia y debe tener todos los permisos necesarios.

Precaución: Por el momento, no puedes configurar notificaciones con la herramienta de línea de comandos.

Por ejemplo, con el siguiente comando se crea una transferencia de datos de Merchant Center llamada My Transfer con el ID de Merchant 1234 y el conjunto de datos de destino mydataset. La transferencia de datos se crea en tu proyecto predeterminado.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

La primera vez que ejecutes el comando, recibirás un mensaje similar al siguiente:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Sigue las instrucciones del mensaje y pega el código de autenticación en la línea de comandos.

Precaución: Cuando crees una transferencia de datos de Merchant Center a través de la herramienta de línea de comandos, la configuración de transferencia se configura con los valores predeterminados de Programa (cada 24 horas al momento de la creación). La primera ejecución de transferencia se iniciará de inmediato, fallará y mostrará el siguiente mensaje de error: “No se encontraron datos para transferir en la cuenta de Merchant”.

Si acabas de crear esta transferencia de datos, es posible que debas esperar hasta un día antes de que los datos de tu cuenta de Merchant estén listos para la transferencia.La siguiente ejecución programada se debe ejecutar de forma correcta. Si los datos de tu cuenta de Merchant están listos en la misma fecha en la hora UTC, puedes configurar un reabastecimiento para la ejecución de hoy.

API

Usa el método projects.locations.transferConfigs.create y suministra una instancia del recurso TransferConfig.

Soluciona problemas relacionados con la configuración de la transferencia de Merchant Center

Si tienes problemas para configurar tu transferencia de datos, consulta la sección sobre problemas de transferencia de Merchant Center en la página sobre cómo solucionar problemas relacionados con la transferencia del Servicio de transferencia de datos de BigQuery.