googleads shopping samples

Muestras para la API de contenido para compras y el centro de fabricantes API

Estas muestras de código están organizadas por plataforma o lenguaje. Cada directorio de idiomas contiene un README con más información sobre cómo ejecutar las muestras para ese idioma en particular. Aquí, cubrimos la configuración de la autenticación y el archivo de configuración común utilizado por todas las muestras.

Para obtener más información sobre las API, consulte la documentación de la API de contenido para las compras y la API del Centro de Fabricantes.

Elija su método de autenticación

Antes de comenzar, consulte la sección de inicio de la API de contenido para la documentación de compras. Es posible que desee utilizar cuentas de servicio para simplificar el flujo de autenticación. Estas muestras también admiten el uso de las credenciales predeterminadas de la aplicación Google.

La configuración de la autenticación para la API del centro del fabricante es similar a la API de contenido. Solo asegúrese de seleccionar la API del Centro del Fabricante en la consola API. Ambas API se pueden seleccionar si desea probar muestras para ambas API.

Configuración de la configuración de autenticación y muestra

1. Cree el directorio $(HOME)/shopping-samples para almacenar la configuración.

   Si no está seguro de dónde se ubicará esto en su configuración particular, ejecute las muestras (siguiendo el README específico del idioma). Los errores de las muestras relacionadas con este directorio o los archivos necesarios no existentes proporcionarán la ruta completa al directorio/archivos esperados.

   Dentro de este directorio, también cree los siguientes subdirectorios, dependiendo de la API que desee probar:

   • content para la API de contenido para comprar
   • manufacturers para la API del centro de fabricantes

   Coloque los archivos descritos a continuación en el subdirectorio apropiado para la API que desea probar.

2. Configure el método de autenticación deseado.

   Si está utilizando las credenciales predeterminadas de la aplicación Google:

   • Siga las instrucciones en la página de credenciales predeterminadas de la aplicación Google.

   Si está utilizando una cuenta de servicio:

   • Coloque el archivo JSON que descargó al crear la cuenta de servicio en el archivo service-account.json en los subdirectorios de configuración API apropiados.

   Si está utilizando una ID de cliente OAuth2:

   • Descargue sus credenciales de cliente OAuth2 al archivo client-secrets.json en los subdirectorios de configuración API apropiados.

     Nota: Las muestras suponen que está utilizando una ID de cliente OAuth2 que puede usar una dirección IP de bucleback para recuperar tokens. Si no está o no está seguro de que está, visite la página [OAUTH2.0 para aplicaciones móviles y de escritorio] (https://developers.google.com/identity/protocols/oauth2installedapp) y siga las instrucciones para crear una Nueva ID de cliente OAUTH2 para usar con las muestras.

   Puede configurar múltiples métodos de autenticación para probar diferentes flujos, pero tenga en cuenta que las muestras siempre usarán las primeras credenciales que se pueden cargar, en el orden:

   1. Credenciales predeterminadas de la aplicación de Google
   2. Credenciales de cuentas de servicio
   3. Credenciales del cliente OAuth2

3. Cada conjunto de muestras utiliza un archivo de configuración diferente. Para la API de contenido para comprar, tome el ejemplo merchant-info.json de la raíz del repositorio y cópelo en $(HOME)/shopping-samples/content . A continuación, cambie su contenido adecuadamente. Contiene un objeto JSON con los siguientes campos:

   Campo	Tipo	Descripción
   merchantId	número	La identificación del centro comercial para ejecutar muestras.
   accountSampleUser	cadena	Si no está vacío, la dirección de correo electrónico para que el usuario agregue/elimine las muestras para el servicio Accounts .
   accountSampleAdWordsCID	número	Si no es cero, la identificación del cliente de AdWords para vincular/no unk en muestras para el servicio Accounts .

   Para la API del Centro de Fabricantes, tome el ejemplo manufacturer-info.json de la raíz del repositorio y cifíquela en $(HOME)/shopping-samples/manufacturers . A continuación, cambie su contenido adecuadamente. Contiene un objeto JSON con los siguientes campos:

   Campo	Tipo	Descripción
   manufacturerId	número	La identificación del centro del fabricante para ejecutar muestras.
   websiteUrl	cadena	La URL (sin barra de corte) asociada con la cuenta central del fabricante.

   Si usa las credenciales del cliente OAUTH2, una vez que haya autorizado el acceso, los detalles del token se almacenarán en el archivo stored-token.json en el directorio de configuración de las muestras. Si tiene algún problema de autenticación, elimine este archivo y se le pedirá que vuelva a autorizar el acceso.

Prueba las muestras

Ahora que ha configurado tanto el archivo de configuración de muestra común como configurar sus credenciales de autenticación, es hora de construir y ejecutar cualquiera de las muestras incluidas. Como se mencionó anteriormente, existen instrucciones específicas del lenguaje en los README ubicados en cada subdirectorio de idiomas. ¡Divertirse!

Posibles problemas

• Al usar la API de contenido para comprar, si no ha configurado la configuración de impuestos en su cuenta, puede recibir un error al ejecutar ciertas muestras. Si recibe un error de "configuración de impuestos faltante", establezca su configuración de impuestos en el centro comercial antes de probar estas muestras. Seleccionar el entorno "No cobre impuestos en los Estados Unidos" es suficiente.