Instagram

O conetor do Instagram permite-lhe realizar operações de inserção, eliminação, atualização e leitura no Instagram.

Antes de começar

Antes de usar o conector do Instagram, faça as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (API Connectors)

      Para saber como ativar serviços, consulte o artigo Ativar serviços.

    Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configuração do Instagram

Para criar uma app que se integre com o Instagram, conclua as seguintes tarefas:

  • Configure uma conta empresarial do Instagram
  • Crie uma conta de programador do Facebook
  • Configure a autenticação de cliente OAuth 2.0
  • Configure os detalhes do âmbito
  • Configure os detalhes do URL de redirecionamento

Configure uma conta empresarial do Instagram

  1. Inicie sessão na conta do Instagram.
  2. Se for um novo utilizador, abra a app e siga as instruções para criar uma nova conta. Pode inscrever-se com um endereço de email, um número de telefone ou através da aplicação Facebook.
  3. Se já for utilizador, inicie sessão na sua conta existente.
  4. Para obter informações sobre como criar uma nova conta empresarial do Instagram, consulte o artigo Conta do Instagram.

  5. Associe uma página do Facebook.
  6. Durante a configuração, o Instagram oferece-lhe a opção de estabelecer ligação a uma página do Facebook. Este passo é opcional, mas recomendado para aceder a todas as funcionalidades.

    Pode criar uma nova página do Facebook diretamente através da configuração ou associá-la a uma página existente.

Crie uma conta de programador do Facebook para a criação e configuração de apps

Inicie sessão com a conta do Facebook que criou anteriormente.

  1. Inicie sessão na conta de programador do Facebook.
  2. Clique em As minhas apps e selecione Criar app.
  3. Escolha a plataforma da sua app na lista de opções, como iOS, Android, Web, etc.
  4. Introduza informações básicas na sua app, como o nome, o endereço de email e a categoria.
  5. Clique em Criar ID da app depois de introduzir as informações necessárias para gerar um identificador exclusivo para a sua app.
  6. Configure definições adicionais na sua app, adicionando detalhes específicos da plataforma, como o ID do pacote iOS, o nome do pacote Android e a configuração de domínios de apps e URLs da política de privacidade.
  7. Para obter informações sobre como criar uma app, consulte o artigo Crie uma app.

  8. Configure a API Instagram Graph.
    1. Navegue para as definições da sua app.
    2. Adicione o produto API Instagram Graph à sua app através do painel de controlo.
    3. No painel de controlo da app, clique em Configurar abaixo de Instagram
    4. Configure as definições de acordo com as necessidades da sua app, incluindo a definição de autorizações. Para obter informações sobre a configuração da API Instagram Graph, consulte o artigo API Instagram Graph.
  9. Adicione autorizações de acesso.

    Peça as autorizações necessárias para os dados de que precisa. Normalmente, isto inclui autorizações como instagram_basic, instagram_manage_comments, instagram_content_publish, instagram_manage_insights, pages_show_list, etc.

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

  10. Se a sua app exigir dados adicionais, tem de enviá-la para revisão de apps pelo Facebook. Para tal, tem de descrever como a sua app usa os dados, fornecendo uma gravação de ecrã da utilização real, para garantir que cumpre a política da plataforma.

  11. Associe a sua conta empresarial do Instagram.
    1. Certifique-se de que a sua conta do Instagram é uma conta empresarial ou de criador, uma vez que a API Instagram Graph não funciona com contas pessoais.
    2. Associe esta conta do Instagram a uma página do Facebook.

    Configure a autenticação de cliente OAuth 2.0

    1. Inicie sessão na Meta for Developers com as suas credenciais do Facebook.
    2. Clique no separador Apps e escolha a app Meta que criou no passo anterior.
    3. Clique em Definições da app > Básico no menu.
    4. Veja o segredo da app, que é o segredo do cliente. Clique em Mostrar. É-lhe pedida a palavra-passe da sua conta. Guarde o segredo do cliente para utilização posterior.
    5. Clique em Definições da app > Avançadas no menu. Encontre o token do cliente, que é o ID de cliente. Se necessário, pode repô-lo.

    Configure os detalhes do âmbito

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

    Configure os detalhes do URL de redirecionamento

    1. Inicie sessão no Meta for Developers com as suas credenciais do Facebook.
    2. Clique no separador Apps e escolha a app Meta que criou no passo anterior.
    3. Clique em facebook Iniciar sessão > Definições no menu.
    4. Cole o URL de redirecionamento gerado em URIs de redirecionamento OAuth válidos no campo obrigatório.

    Configure o conetor

    Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

    1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

      Aceda à página Ligações

    2. Clique em + Criar novo para abrir a página Criar associação.
    3. Na secção Localização, escolha a localização para a ligação.
      1. Região: selecione uma localização na lista pendente.

        As regiões suportadas para conetores incluem:

        Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

      2. Clicar em Seguinte.
    4. Na secção Detalhes da associação, conclua o seguinte:
      1. Conetor: selecione Instagram na lista pendente de conetores disponíveis.
      2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
      3. No campo Nome da ligação, introduza um nome para a instância de ligação.

        Os nomes das associações têm de cumprir os seguintes critérios:

        • Os nomes das associações podem usar letras, números ou hífenes.
        • As letras têm de ser minúsculas.
        • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
        • Os nomes das associações não podem exceder 49 carateres.
      4. Opcionalmente, introduza uma Descrição para a instância de associação.
      5. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
      6. Opcionalmente, configure as definições do nó de associação:

        • Número mínimo de nós: introduza o número mínimo de nós de ligação.
        • Número máximo de nós: introduza o número máximo de nós de ligação.

        Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

      7. Nível de detalhe: nível de detalhe para a ligação, varia de 1 a 5. Um nível de detalhe mais elevado regista todos os detalhes de comunicação (pedido,resposta e certificados SSL).
      8. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
      9. Clicar em Seguinte.
    5. Na secção Autenticação, introduza os detalhes de autenticação.
      1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

        A ligação do Instagram suporta os seguintes tipos de autenticação:

        • Concessão de código de autorização do OAuth 2.0
      2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

      3. Clicar em Seguinte.
    6. Rever: reveja os detalhes da ligação e da autenticação.
    7. Clique em Criar.

    Exemplos de configuração de ligação

    Esta secção apresenta os valores de exemplo dos vários campos que configura quando cria a associação do Instagram.

    Tipo de ligação da Web do Instagram

    Nome do campo Detalhes
    Localização europe-west1
    Conetor instagram
    Versão do conetor 1
    Nome da ligaçã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
    Âmbitos instagram_basic,pages_show_list,pages_read_engagement
    Segredo do cliente CLIENT_SECRET
    Versão do Secret 2

    Configure a autenticação

    Introduza os detalhes com base na autenticação que quer usar.

    • Concessão de código de autorização OAuth 2.0
      • ID de cliente: o ID de cliente usado para pedir tokens de acesso.
      • Âmbitos: uma lista separada por vírgulas dos âmbitos pretendidos.
      • Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
      • Versão do Secret: a versão do Secret que contém o segredo do cliente.

    Nova autorização para o código de autorização

    Se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na sua aplicação do Azure AD, tem de voltar a autorizar a ligação do Azure AD. Para autorizar novamente uma associação, siga estes passos:

    1. Clique na associação necessária na página Associações.

      É apresentada a página de detalhes da associação.

    2. Clique em Editar para editar os detalhes da associação.
    3. Valide os detalhes de OAuth 2.0 – Código de autorização na secção Autenticação.

      Se necessário, faça as alterações necessárias.

    4. Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
    5. Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
    6. Clique em Autorizar.

      Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

    Passos adicionais após a criação da associação

    Se selecionou OAuth 2.0 - Authorization code para a autenticação, tem de realizar os seguintes passos adicionais após criar a associação:

    1. Na página Ligações, encontre a ligação criada recentemente.

      Tenha em atenção que o Estado do novo conetor é Autorização necessária.

    2. Clique em Autorização obrigatória.

      É apresentado o painel Editar autorização.

    3. Copie o valor do URI de redirecionamento para a sua aplicação externa.
    4. Valide os detalhes da autorização.
    5. Clique em Autorizar.

      Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

    Entidades, operações e ações

    Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

    • Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.

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

    • Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:

      Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.

    • Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

    Limitações do sistema

    O conector do Instagram pode processar 2 transações por segundo, por nó, e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

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

    Exemplos de ações

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

    Exemplo: liste 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, de seguida, clique em Concluído.

    Exemplo: listar todos os AccountFollowersNonfollowers

    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, de seguida, clique em Concluído.
    4. Defina a cláusula de filtro para List single AccountFollowersNonfollowers. Para definir a cláusula de filtro, na secção Mapeamento de dados do Mapeador de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza Metric='reach' no campo Valor de entrada e escolha a cláusula de filtro como variável local.

    Tem de usar a cláusula de filtro na secção Mapeador de dados das tarefas para realizar uma operação com a entidade AccountFollowersNonfollowers.

    Exemplo: obtenha um único 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, de seguida, clique em Concluído.
    4. Defina o ID da entidade como Get single IGMedia. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza 18008309540391873 no campo Valor de entrada e escolha EntityId como variável local.

    Exemplo: obtenha 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, de seguida, clique em Concluído.
    4. Defina a cláusula de filtro para obter MediaInsightReels individuais. Para definir a cláusula de filtro, na secção Mapeamento de dados do Mapeador de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza MediaId='18018014180193817' no campo Valor de entrada e escolha a cláusula de filtro como variável local.

    Tem de usar a cláusula de filtro na secção Mapeador de dados das tarefas para executar uma operação Get para as seguintes entidades: MediaInsightReels, MediaInsights, MediaInsightsPost, AccountFollowersNonfollowers e AccountContactButtonType.

    Exemplo: elimine 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, de seguida, clique em Concluído.
    4. Defina o ID da entidade como Eliminar comentários. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza 18435078259055638 no campo Valor de entrada e escolha 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, de seguida, clique em Concluído.
    4. Na secção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e, de seguida, introduza um valor semelhante ao seguinte em field:
       {
      "MediaId": "18008309540391873",
      "Text": "The Universe is with you"
      }

      A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

      {
      "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, de seguida, clique em Concluído.
    4. Na secção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e, de seguida, introduza um valor semelhante ao seguinte em field:
       {
      "CommentId": "18022630739158714",
      "Text": "conquered" 
      }

      A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

      {
      "Id": "18167970637306971"
      }

    Use a associação do Instagram numa integração

    Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

    • Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
    • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

    Obtenha ajuda da comunidade do Google Cloud

    Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

    O que se segue?