googleads shopping samples

Échantillons pour l'API de contenu pour l'achat et l'API Centre des fabricants

Ces échantillons de code sont organisés par plate-forme ou langage. Chaque répertoire linguistique contient une README avec plus d'informations sur la façon d'exécuter les échantillons pour cette langue particulière. Ici, nous couvrons la configuration de l'authentification et le fichier de configuration commun utilisé par tous les échantillons.

Pour plus d'informations sur les API, veuillez vous référer à la documentation de l'API de contenu pour les achats et de l'API du fabricant Centre.

Choisissez votre méthode d'authentification

Avant de commencer, consultez la section de démarrage de l'API de contenu pour la documentation d'achat. Vous souhaiterez peut-être utiliser des comptes de service à la place pour simplifier le flux d'authentification. Ces échantillons prennent également en charge l'utilisation d'identification par défaut de l'application Google.

La configuration de l'authentification pour l'API du Centre du fabricant est similaire à l'API de contenu. Assurez-vous de sélectionner l'API Centre du fabricant dans la console API. Les deux API peuvent être sélectionnées si vous souhaitez essayer des échantillons pour les deux API.

Configuration de l'authentification et de la configuration de l'échantillon

1. Créez le répertoire $(HOME)/shopping-samples pour stocker la configuration.

   Si vous ne savez pas où cela sera situé dans votre configuration particulière, exécutez les échantillons (en suivant la README spécifique à la langue). Les erreurs des échantillons liés à ce répertoire ou aux fichiers nécessaires qui ne seront pas existants fourniront le chemin complet du répertoire / fichiers attendus.

   Dans ce répertoire, créez également les sous-répertoires suivants, selon l'API que vous souhaitez essayer:

   • content pour l'API de contenu pour faire du shopping
   • manufacturers de l'API Centre du fabricant

   Placez les fichiers décrits ci-dessous dans le sous-répertoire approprié pour l'API que vous souhaitez essayer.

2. Configurez la méthode d'authentification souhaitée.

   Si vous utilisez des informations d'identification par défaut de l'application Google:

   • Suivez les instructions sur la page des informations d'identification par défaut de l'application Google.

   Si vous utilisez un compte de service:

   • Mettez le fichier JSON que vous avez téléchargé lors de la création du compte de service dans le fichier service-account.json dans les sous-répertoires de configuration de l'API appropriés.

   Si vous utilisez un ID client OAuth2:

   • Téléchargez vos informations d'identification client OAuth2 dans le fichier client-secrets.json dans les sous-répertoires de configuration de l'API appropriés.

     Remarque: Les échantillons supposent que vous utilisez un ID client OAuth2 qui peut utiliser une adresse IP en boucle pour récupérer les jetons. Si vous n'êtes pas ou n'êtes pas sûr que vous ne l'êtes, veuillez visiter le [OAuth2.0 pour les applications mobiles et de bureau] (https://developers.google.com/identity/protocols/oauth2installedapp) et suivez les instructions pour créer un Nouvel ID client OAuth2 à utiliser avec les échantillons.

   Vous pouvez configurer plusieurs méthodes d'authentification pour essayer différents flux, mais notez que les échantillons utiliseront toujours les premières informations d'identification qui peuvent être chargées, dans l'ordre:

   1. Informations sur les informations par défaut de l'application Google
   2. Informations sur les comptes de service
   3. Identification des clients OAuth2

3. Chaque ensemble d'échantillons utilise un fichier de configuration différent. Pour l'API de contenu pour faire du shopping, prenez l'exemple merchant-info.json à partir de la racine du référentiel et copiez-le dans $(HOME)/shopping-samples/content . Ensuite, modifiez son contenu de manière appropriée. Il contient un objet JSON avec les champs suivants:

   Champ	Taper	Description
   merchantId	nombre	L'identité du centre marchand pour exécuter des échantillons contre.
   accountSampleUser	chaîne	Si non vide, l'adresse e-mail pour l'utilisateur peut ajouter / supprimer dans des échantillons pour le service Accounts .
   accountSampleAdWordsCID	nombre	Si non zéro, l'ID client AdWords pour lier / dissocier dans des échantillons pour le service Accounts .

   Pour l'API du Centre du fabricant, prenez l'exemple manufacturer-info.json à partir de la racine du référentiel et copiez-le en $(HOME)/shopping-samples/manufacturers . Ensuite, modifiez son contenu de manière appropriée. Il contient un objet JSON avec les champs suivants:

   Champ	Taper	Description
   manufacturerId	nombre	L'identité du fabricant pour exécuter des échantillons contre.
   websiteUrl	chaîne	L'URL (sans slash de fuite) associée au compte du centre du fabricant.

   Si vous utilisez des informations d'identification du client OAuth2, une fois que vous aurez autorisé l'accès, vos détails de jeton seront stockés dans le fichier stored-token.json dans le répertoire de configuration des échantillons. Si vous avez des problèmes authentifiant, supprimez ce fichier et il vous sera demandé de réautoriser l'accès.

Essayez les échantillons

Maintenant que vous avez configuré à la fois le fichier de configuration d'échantillon commun et configuré vos informations d'identification d'authentification, il est temps de créer et d'exécuter l'un des échantillons inclus. Comme mentionné précédemment, il existe des instructions spécifiques à la langue dans les README situées dans chaque sous-répertoire de langue. Amusez-vous!

Problèmes possibles

• Lorsque vous utilisez l'API de contenu pour les achats, si vous n'avez pas configuré les paramètres d'impôt sur votre compte, vous pouvez obtenir une erreur lorsque vous exécutez certains échantillons. Si vous recevez une erreur "Paramètres fiscaux manquants", définissez vos paramètres fiscaux dans le centre marchand avant d'essayer ces échantillons. La sélection du paramètre "Ne facturez pas les impôts aux États-Unis" est suffisant.