Instagram

Le connecteur Instagram vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur Instagram.

Avant de commencer

Avant d'utiliser le connecteur Instagram, effectuez les tâches suivantes :

• Dans votre projet Google Cloud :
  • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus sur les schémas de réseau, consultez Connectivité réseau.
  • Activez les services suivants :
    • secretmanager.googleapis.com (API Secret Manager)
    • connectors.googleapis.com (API Connectors)

    Pour savoir comment activer des services, consultez Activer des services.

  Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer au moment de configurer le connecteur.

Configuration d'Instagram

Pour créer une application qui s'intègre à Instagram, voici ce que vous devez faire :

• Configurer un compte professionnel Instagram
• Créer un compte de développeur Facebook
• Configurer l'authentification client OAuth 2.0
• Configurer les détails du niveau d'accès
• Configurer les détails de l'URL de redirection

Configurer un compte professionnel Instagram

1. Connectez-vous à votre compte Instagram.
2. Si vous êtes un nouvel utilisateur, ouvrez l'application et suivez les instructions pour créer un compte. Vous pouvez vous inscrire avec une adresse e-mail, un numéro de téléphone ou par le biais de l'application Facebook.
3. Si vous avez déjà un compte Instagram, connectez-vous-y.

Pour savoir comment créer un compte professionnel Instagram, consultez Compte Instagram.

4. Connectez-vous à une page Facebook.

Lors de la configuration, Instagram vous propose de vous connecter à une page Facebook. Cette étape est facultative, mais recommandée pour accéder à toutes les fonctionnalités.

Vous pouvez créer une page Facebook directement lors de la configuration ou associer une page qui existe déjà.

Créer un compte de développeur Facebook pour concevoir et configurer des applications

Connectez-vous à l'aide du compte Facebook que vous avez créé précédemment.

1. Connectez-vous au compte de développeur Facebook.
2. Cliquez sur Mes applications, puis sélectionnez Créer une app.
3. Choisissez la plate-forme de votre application dans la liste (iOS, Android, Web, etc.).
4. Saisissez des informations de base dans votre application, telles que le nom, l'adresse e-mail et la catégorie.
5. Cliquez sur Créer un ID d'app après avoir saisi les informations nécessaires pour générer un identifiant unique pour votre application.
6. Configurez des paramètres supplémentaires dans votre application en ajoutant des informations spécifiques à la plate-forme, telles que l'ID du bundle iOS, le nom du package Android, la configuration des domaines d'application et les URL des règles de confidentialité.

Pour en savoir plus sur la création d'applications, consultez Créer une application.

7. Configurez l'API Instagram Graph.
1. Accédez aux paramètres de votre application.
2. Ajoutez le produit API Instagram Graph à votre application au moyen du tableau de bord.
3. Dans le tableau de bord de votre application, cliquez sur Configurer sous Instagram.
4. Configurez les paramètres en fonction des besoins de votre application, y compris les autorisations. Pour en savoir plus sur la configuration de l'API Instagram Graph, consultez API Instagram Graph.
8. Ajoutez des autorisations d'accès.

   Demandez les autorisations nécessaires pour les données dont vous avez besoin. Il s'agit généralement d'autorisations comme instagram_basic, instagram_manage_comments, instagram_content_publish, instagram_manage_insights et pages_show_list.

   Chaque autorisation définit le type de données ou d'actions que vous pouvez effectuer avec l'API. Pour en savoir plus sur les autorisations, consultez Autorisations et autorisations.

Si votre application nécessite des données supplémentaires, vous devez l'envoyer pour examen à Facebook. Pour ce faire, vous devez décrire la façon dont votre application utilise les données en fournissant un enregistrement d'écran de l'utilisation réelle afin de vous assurer que vous respectez le règlement de la plate-forme.

9. Associez votre compte d'entreprise Instagram.
1. Assurez-vous que votre compte Instagram est un compte d'entreprise ou de créateur, car l'API Instagram Graph ne fonctionne pas avec les comptes personnels.
2. Associez ce compte Instagram à une page Facebook.

Configurer l'authentification client OAuth 2.0

1. Connectez-vous à Meta for Developers à l'aide de vos identifiants Facebook.
2. Cliquez sur l'onglet "Apps" (Applications), puis sélectionnez l'application Meta que vous avez créée à l'étape précédente.
3. Dans le menu, cliquez sur App Settings > Basic (Paramètres de l'application > De base).
4. Affichez le code secret de l'application, qui constitue le code secret du client. Cliquez sur "Show" (Afficher). Vous serez invité à saisir le mot de passe de votre compte. Enregistrez le code secret du client pour une utilisation ultérieure.
5. Dans le menu, cliquez sur App Settings > Advanced (Paramètres de l'application > Avancés). Recherchez le jeton client, qui constitue l'ID client. Vous pouvez le réinitialiser si nécessaire.

Configurer les détails du niveau d'accès

Vous pouvez définir des niveaux d'accès en fonction des besoins de votre entreprise. Les niveaux d'accès ont été définis sur "instagram_basic", "pages_show_list" et "pages_read_engagement".

Configurer les détails de l'URL de redirection

1. Connectez-vous à Meta for Developers à l'aide de vos identifiants Facebook.
2. Cliquez sur l'onglet "Apps" (Applications), puis sélectionnez l'application Meta que vous avez créée à l'étape précédente.
3. Dans le menu Facebook, cliquez sur Login > Settings (Connexion > Paramètres).
4. Collez l'URL de redirection générée sous Valid OAuth Redirect URIs (URI de redirection OAuth valides) dans le champ obligatoire.

Configurer le connecteur

Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

1. Dans la console Cloud, accédez à la page Connecteurs d'intégration > Connexions, puis sélectionnez ou créez un projet Google Cloud.

   Accéder à la page "Connexions"

2. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
   1. Région : sélectionnez un emplacement dans la liste déroulante.

      Les régions disponibles pour les connecteurs sont les suivantes :

      Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

   2. Cliquez sur Suivant.
4. Dans la section Détails de la connexion, procédez comme suit :
   1. Connecteur : sélectionnez Instagram dans la liste déroulante des connecteurs disponibles.
   2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
   3. Dans le champ Nom de connexion, indiquez le nom de l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Ils peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Ils ne peuvent pas dépasser 49 caractères.
   4. (Facultatif) Saisissez une description de l'instance de connexion.
   5. Compte de service : sélectionnez un compte de service disposant des rôles requis.
   6. (Facultatif) Configurez les paramètres de nœuds de connexion :
      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

   Remarque : Vous ne pouvez personnaliser les valeurs des nœuds de connexion que si vous avez opté pour le paiement à l'usage.
   7. Niveau de verbosité : niveau de verbosité de la connexion (de 1 à 5). Un niveau de verbosité plus élevé consigne tous les détails de la communication (requête, réponse et certificats SSL).
   8. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
   9. Cliquez sur Suivant.
5. Dans la section Authentification, saisissez les informations d'authentification.
   1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion Instagram :

      • Attribution de code d'autorisation OAuth 2.0

   Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.

   2. Cliquez sur Suivant.
6. Vérifier : vérifiez vos informations de connexion et d'authentification.
7. Cliquez sur Créer.

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion Instagram.

Type de connexion Web Instagram

Nom du champ	Détails
Emplacement	europe-west1
Connecteur	instagram
Version du connecteur	1
Nom de connexion	google-cloud-instagram
Compte de service	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Niveau de verbosité	5
Nombre minimal de nœuds	2
Nombre maximal de nœuds	50
ID client	CLIENT_ID
Niveaux d'accès	instagram_basic,pages_show_list,pages_read_engagement
Code secret du client	CLIENT_SECRET
Version du secret	2

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

• Attribution de code d'autorisation OAuth 2.0
  • ID client : ID client utilisé pour demander des jetons d'accès
  • Niveaux d'accès : liste des niveaux d'accès souhaités, séparés par une virgule
  • Code secret du client : code secret du client utilisé pour demander des jetons d'accès
  • Version du secret : version du secret contenant le code secret du client

Accorder une nouvelle autorisation pour le code d'autorisation

Si vous utilisez le type d'authentification Authorization code et que vous avez modifié la configuration de votre application Azure AD, vous devez autoriser à nouveau votre connexion Azure AD. Pour autoriser à nouveau une connexion, procédez comme suit :

1. Sur la page Connexions, cliquez sur la connexion requise.

   La page de détails de la connexion s'ouvre.

2. Cliquez sur Modifier pour modifier les détails de la connexion.
3. Dans la section Authentification, vérifiez les détails du code d'autorisation OAuth 2.0.

   Apportez des modifications, si besoin.

4. Cliquez sur Enregistrer. La page de détails de la connexion s'affiche.
5. Dans la section Authentification, cliquez sur Modifier l'autorisation. Le volet Autoriser s'affiche.
6. Cliquez sur Autoriser.

   Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Étapes supplémentaires après la création de la connexion

Si vous avez sélectionné OAuth 2.0 - Authorization code pour l'authentification, vous devez effectuer les étapes supplémentaires ci-dessous après avoir créé la connexion :

1. Sur la page Connexions, recherchez la connexion que vous venez de créer.

   Notez que l'état du nouveau connecteur sera Autorisation requise.

2. Cliquez sur Autorisation requise.

   Le volet Modifier l'autorisation s'affiche.

3. Copiez la valeur de l'URI de redirection dans votre application externe.
4. Vérifiez les détails de l'autorisation.
5. Cliquez sur Autoriser.

   Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Entités, opérations et actions

Tous les connecteurs d'intégration fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

Remarque : Vous pouvez afficher les entités, les opérations et les actions d'un connecteur dans la tâche "Connecteurs".
• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.
Remarque : Toutes les entités et les actions seront associées à un schéma. Par exemple, un schéma d'action contient les détails des paramètres tels que les noms des paramètres et le type de données correspondant. Le schéma (métadonnées) des entités et des actions est récupéré par la connexion au moment de l'exécution à partir de votre backend. Si des modifications sont apportées au schéma, elles ne sont pas automatiquement répercutées dans vos connexions existantes. Vous devez actualiser manuellement le schéma. Pour actualiser le schéma d'une connexion, ouvrez la page Détails de la connexion, puis cliquez sur Actualiser le schéma de connexion.

Limites du système

Le connecteur Instagram peut traiter deux transactions par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Remarque : L'autoscaling du nombre de nœuds Integration Connectors s'effectue de manière dynamique en fonction de votre utilisation. Toutefois, si vous souhaitez réserver de la capacité pour de gros volumes sans attendre l'autoscaling, vous pouvez ajuster le nombre minimal de nœuds pour une connexion. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour configurer les valeurs de nœuds, procédez comme suit :

• Si vous avez opté pour le paiement à l'usage, configurez le nombre minimal et le nombre maximal de nœuds sur la page "Modifier la connexion".
• Si vous avez souscrit un abonnement, contactez l'assistance.

Le nombre maximal de transactions qu'un nœud peut traiter dépend de plusieurs facteurs. Par conséquent, avant d'ajuster le nombre minimal de nœuds pour améliorer le débit, nous vous recommandons de vérifier si vos systèmes backend sont configurés de manière optimale pour gérer le trafic requis.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Lister tous les IGMedia

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "IGMedia" dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.

Exemple : Lister tous les AccountFollowersNonfollowers

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "AccountFollowersNonfollowers" dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Définissez la clause de filtre sur "Lister un seul élément AccountFollowersNonfollowers". Pour définir la clause de filtre, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez Metric='reach' dans le champ Valeur d'entrée et sélectionnez la clause de filtre comme variable locale.

Vous devez utiliser la clause de filtre dans la section Data Mapper des tâches pour effectuer une opération avec l'entité AccountFollowersNonfollowers.

Exemple : Récupérer un seul IGMedia

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "IGMedia" dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Récupérer un seul IGMedia". Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 18008309540391873 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Récupérer les MediaInsightReels

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "MediaInsightReels" dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Définissez la clause de filtre sur "Récupérer un seul MediaInsightReels". Pour définir la clause de filtre, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez MediaId='18018014180193817' dans le champ Valeur d'entrée et sélectionnez la clause de filtre comme variable locale.

Vous devez utiliser la clause de filtre dans la section Data Mapper des tâches pour effectuer une opération Get pour les entités suivantes : MediaInsightReels, MediaInsights, MediaInsightsPost, AccountFollowersNonfollowers et AccountContactButtonType.

Exemple : Supprimer un commentaire

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Comments" dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Supprimer les commentaires". Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 18435078259055638 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Créer un commentaire

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Comments" dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche, cliquez sur l'éditeur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le field:

    {
   "MediaId": "18008309540391873",
   "Text": "The Universe is with you"
   }

   L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
   "Id": "18351045133102133"
   }

Exemple : Créer une réponse

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Replies" dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche, cliquez sur l'éditeur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le field:

    {
   "CommentId": "18022630739158714",
   "Text": "conquered" 
   }

   L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
   "Id": "18167970637306971"
   }

Utiliser la connexion Instagram dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

• Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez Tâche "Connecteurs".
• Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes

• Découvrez comment suspendre et reprendre une connexion.
• Découvrez comment surveiller l'utilisation des connecteurs.
• Découvrez comment afficher les journaux des connecteurs.