Instagram

Com o conector do Instagram, você pode realizar operações de inserção, exclusão, atualização e leitura no Instagram.

Antes de começar

Antes de usar o conector do Instagram, faça o seguinte:

• No seu projeto do Google Cloud, faça o seguinte:
  • Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede.
  • Ative os seguintes serviços:
    • secretmanager.googleapis.com (API Secret Manager)
    • connectors.googleapis.com (API Connectors)

    Para entender como ativar os serviços, consulte Como ativar serviços.

  Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los ao configurar o conector.

Configuração do Instagram

Para criar um app que se integra ao Instagram, siga estas etapas:

• Configurar uma conta comercial do Instagram
• Criar uma conta de desenvolvedor do Facebook
• Configurar a autenticação do cliente OAuth2.0
• Configurar detalhes do escopo
• Configurar os detalhes do URL de redirecionamento

Configurar uma conta comercial do Instagram

1. Faça login na conta do Instagram.
2. Se você for um usuário novo, abra o app e siga as instruções para criar uma conta. Você pode se inscrever com um endereço de e-mail, número de telefone ou pelo aplicativo do Facebook.
3. Se você já for usuário, faça login na sua conta.

Para saber como criar uma conta comercial do Instagram, consulte Conta do Instagram.

4. Conectar a uma página do Facebook.

Durante a configuração, o Instagram oferece a opção de se conectar a uma página do Facebook. Isso é opcional, mas recomendado para acessar todos os recursos.

Você pode criar uma nova página do Facebook diretamente na configuração ou vincular uma página já existente.

Criar uma conta de desenvolvedor do Facebook para criar e configurar apps

Faça login usando a conta do Facebook que você criou anteriormente.

1. Faça login na conta de desenvolvedor do Facebook.
2. Clique em Meus apps e selecione Criar app.
3. Escolha a plataforma do app na lista de opções, como iOS, Android, Web etc.
4. Insira informações básicas no app, como nome, endereço de e-mail e categoria.
5. Clique em Criar ID do app depois de inserir as informações necessárias para gerar um identificador exclusivo para o app.
6. Configure outras configurações no app adicionando detalhes específicos da plataforma, como o ID do pacote do iOS, o nome do pacote do Android, a configuração de domínios do app e URLs da política de privacidade.

Para saber como criar um app, consulte Criar um app.

7. Configure a API Graph do Instagram.
1. Acesse as configurações do app.
2. Adicione o produto API Graph do Instagram ao seu app pelo painel.
3. No painel do app, clique em Configurar em "Instagram".
4. Defina as configurações de acordo com as necessidades do app, incluindo as permissões. Para saber como configurar a API Instagram Graph, consulte API Instagram Graph.
8. Adicione permissões para acesso.

   Solicite as permissões necessárias para os dados que você precisa. Isso normalmente inclui permissões como instagram_basic, instagram_manage_comments, instagram_content_publish, instagram_manage_insights, pages_show_list etc.

   Cada permissão define o tipo de dados ou ações que você pode realizar com a API. Para informações sobre permissões, consulte Autorização e permissões.

Se o app precisar de dados adicionais, envie-o para a análise do Facebook. Para isso, você precisa descrever como o app usa os dados, fornecendo um screencast do uso real, para garantir que está obedecendo à política do Google Play.

9. Vincule sua conta comercial do Instagram.
1. Verifique se sua conta do Instagram é comercial ou de criador de conteúdo, porque a API Instagram Graph não funciona com contas pessoais.
2. Vincule esta conta do Instagram a uma Página do Facebook.

Configurar a autenticação do cliente OAuth2.0

1. Faça login no Meta for Developers usando suas credenciais do Facebook.
2. Clique na guia "Apps" e escolha o metaapp que você criou na etapa anterior.
3. Clique em Configurações do app > Básico no menu.
4. Confira a chave secreta do app, que é a chave secreta do cliente. Clique em "Mostrar". Você vai precisar da senha da sua conta. Salve a chave secreta do cliente para uso posterior.
5. Clique em Configurações do app > Avançado no menu. Encontre o token do cliente, que é o ID do cliente. É possível redefinir o dispositivo, se necessário.

Configurar detalhes do escopo

Os escopos podem ser definidos de acordo com as necessidades da sua empresa. Os escopos foram definidos como instagram_basic, pages_show_list e pages_read_engagement.

Configurar os detalhes do URL de redirecionamento

1. Faça login no Meta for Developers usando suas credenciais do Facebook.
2. Clique na guia "Apps" e escolha o metaapp que você criou na etapa anterior.
3. Clique em Fazer login > Configurações no menu.
4. Cole o URL de redirecionamento gerado em URIs de redirecionamento OAuth válidos no campo obrigatório.

Configurar o conector

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

   Acessar a página "Conexões"

2. Clique em + Criar novo para abrir a página Criar conexão.
3. Na seção Local, escolha o local da conexão.
   1. Região: selecione um local na lista suspensa.

      Veja abaixo as regiões compatíveis com o conector:

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

   2. Clique em Próxima.
4. Na seção Detalhes da conexão, faça o seguinte:
   1. Conector: selecione Instagram na lista suspensa de conectores disponíveis.
   2. Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
   3. No campo Nome da conexão, insira um nome para a instância de conexão

      Os nomes de conexão precisam atender aos seguintes critérios:

      • Os nomes de conexões podem usar letras, números ou hifens.
      • As letras precisam ser minúsculas.
      • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das conexões não podem ter mais de 49 caracteres.
   4. Como opção, insira uma Descrição para a instância de conexão.
   5. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
   6. Opcionalmente, defina as Configurações do nó de conexão:
      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

   Observação: você só poderá personalizar os valores do nó de conexão se for um cliente de pagamento por utilização.
   7. Nível de detalhes: varia de 1 a 5. Um nível de detalhamento mais alto registra todos os detalhes de comunicação (solicitação,resposta e certificados SSL).
   8. Outra opção é clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
   9. Clique em Próxima.
5. Na seção Autenticação, insira os detalhes da autenticação.
   1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

      A conexão do Instagram oferece suporte aos seguintes tipos de autenticação:

      • Concessão de código de autenticação do OAuth 2.0

   Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

   2. Clique em Next.
6. Revisão: revise os detalhes de conexão e autenticação.
7. Clique em Criar.

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão do Instagram.

Tipo de conexão da Web do Instagram

Nome do campo	Detalhes
Local	europe-west1
Conector	instagram
Versão do conector	1
Nome da conexão	google-cloud-instagram
Conta de serviço	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Nível de verbosidade	5
Número mínimo de nós	2
Número máximo de nós	50
ID do cliente	CLIENT_ID
Escopos	instagram_basic,pages_show_list,pages_read_engagement
Chave secreta do cliente	CLIENT_SECRET
Versão do secret	2

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

• Autorização de código OAuth 2.0
  • ID do cliente: o ID do cliente usado para solicitar tokens de acesso.
  • Escopos: uma lista separada por vírgulas dos escopos desejados.
  • Chave secreta do cliente: a chave secreta do cliente usada para solicitar tokens de acesso.
  • Versão do secret: a versão do secret que contém a chave secreta do cliente.

Reautorização do código de autorização

Se você estiver usando o tipo de autenticação Authorization code e tiver feito alterações de cofiguração no aplicativo do Azure AD, será necessário autorizar novamente a conexão do Azure AD. Para autorizar novamente uma conexão, siga estas etapas:

1. Clique na conexão necessária na página "Conexões".

   A página de detalhes da conexão será aberta.

2. Clique em Editar para editar os detalhes da conexão.
3. Verifique os detalhes do OAuth 2.0: código de autorização na seção Autenticação.

   Se necessário, faça as mudanças necessárias.

4. Clique em Salvar. Isso leva você à página de detalhes da conexão.
5. Clique em Edit authorization na seção Authentication. O painel Authorize é mostrado.
6. Clique em Autorizar.

   Se a autorização for bem-sucedida, o status da conexão será definido como Ativo na página "Conexões".

Etapas adicionais após a criação da conexão

Se você selecionou OAuth 2.0 - Authorization code para autenticação, siga estas etapas adicionais após criar a conexão:

1. Na página "Conexões", localize a conexão recém-criada.

   O Status do novo conector será Autorização necessária.

2. Clique em Autorização necessária.

   O painel Editar autorização é mostrado.

3. Copie o valor do URI de redirecionamento para seu aplicativo externo.
4. Verifique os detalhes da autorização.
5. Clique em Autorizar.

   Se a autorização for bem-sucedida, o status da conexão será definido como Ativo na página "Conexões".

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

Observação:você pode ver as entidades, as operações e as ações de um conector na tarefa de conectores.
• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações sem suporte não serão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.
Observação : todas as entidades e ações terão um esquema associado a elas. Por exemplo, um esquema de ação terá os detalhes do parâmetro, como: os nomes do parâmetro e tipos de dados correspondentes. O esquema (metadados) de entidades e ações é buscado pela conexão no ambiente de execução do back-end. Se houver atualizações no esquema, elas não serão refletidas automaticamente nas suas conexões. Faça isso manualmente. Para atualizar o esquema de uma conexão, abra a página Detalhes da conexão e clique em Atualizar esquema de conexão.

Limitações do sistema

O conector do Instagram pode processar duas transações por segundo, por nó, e limita qualquer transação além desse limite. Por padrão, os Integration Connectors alocam dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Observação:o número de nós de Integration Connectors vai ser escalonado automaticamente de forma dinâmica com base no seu uso. No entanto, se você quiser reservar capacidade para grandes volumes sem esperar pelo escalonamento automático, ajuste o valor mínimo do nó para uma conexão. Mais nós são necessários para processar mais transações para uma conexão. Por outro lado, menos nós são necessários se uma conexão processa menos transações. Para configurar os valores do nó, faça o seguinte:

• Se você for um cliente de pagamento por utilização, configure o valor mínimo e máximo do nó na página de edição de conexão.
• Se você for um cliente de assinatura, entre em contato com o suporte.

O número máximo de transações que um nó pode processar depende de vários fatores. Portanto, antes de ajustar os nós mínimos para uma melhor taxa de transferência, recomendamos verificar se os sistemas de back-end estão configurados de maneira ideal para processar o tráfego necessário.

Exemplos de ações

Esta seção descreve como realizar algumas das ações neste conector.

Exemplo: listar todos os IGMedia

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione "IGMedia" na lista Entity.
3. Selecione a operação List e clique em Concluído.

Exemplo: listar todos os seguidores e não seguidores da conta

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione "AccountFollowersNonfollowers" na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Defina a cláusula de filtro como "Listar apenas AccountFollowersNonfollowers". Para definir a cláusula de filtro, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e insira Metric='reach' no campo Valor de entrada e escolha a cláusula de filtro como variável local.

Use a cláusula de filtro na seção Mapeador de dados das tarefas para realizar uma operação com a entidade "AccountFollowersNonfollowers".

Exemplo: receber uma única IGMedia

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione "IGMedia" na lista Entity.
3. Selecione a operação Get e clique em Concluído.
4. Defina o ID da entidade como "Get single IGMedia". Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e digite 18008309540391873 no campo Valor de entrada e escolha o EntityId como variável local.

Exemplo: receber MediaInsightReels

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione MediaInsightReels na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Defina a cláusula de filtro como "Get single MediaInsightReels". Para definir a cláusula de filtro, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e insira MediaId='18018014180193817' no campo Valor de entrada e escolha a cláusula de filtro como variável local.

É necessário usar a cláusula de filtro na seção Mapeador de dados das tarefas para realizar uma operação "Get" para as seguintes entidades: MediaInsightReels, MediaInsights, MediaInsightsPost, AccountFollowersNonfollowers e AccountContactButtonType.

Exemplo: excluir um comentário

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione "Comentários" na lista Entity.
3. Selecione a operação Delete e clique em Concluído.
4. Defina o ID da entidade como "Excluir comentários". Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e digite 18435078259055638 no campo Valor de entrada e escolha o EntityId como variável local.

Exemplo: criar um comentário

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione "Comentários" na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da Tarefa, clique no editor OpenDataMapping e insira um valor semelhante ao seguinte no field::

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

   A execução desse exemplo retorna uma resposta semelhante a esta na variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Id": "18351045133102133"
   }

Exemplo: criar uma resposta

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Respostas na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da Tarefa, clique no editor OpenDataMapping e insira um valor semelhante ao seguinte no field::

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

   A execução desse exemplo retorna uma resposta semelhante a esta na variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Id": "18167970637306971"
   }

Usar a conexão do Instagram em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e na integração do aplicativo. É possível usar a conexão em uma integração pela tarefa de conectores.

• Para entender como criar e usar a tarefa "Connectors" na integração da Apigee, consulte Tarefa Connectors.
• Para entender como criar e usar a tarefa "Conectores" na integração de aplicativos, consulte Tarefa "Conectores".

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir

• Entenda como suspender e retomar uma conexão.
• Entenda como monitorar o uso do conector.
• Saiba como acessar os registros do conector.