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
- Inicie sessão na conta do Instagram.
- 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.
- Se já for utilizador, inicie sessão na sua conta existente.
- Associe uma página do Facebook.
Para obter informações sobre como criar uma nova conta empresarial do Instagram, consulte o artigo Conta do Instagram.
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.
- Inicie sessão na conta de programador do Facebook.
- Clique em As minhas apps e selecione Criar app.
- Escolha a plataforma da sua app na lista de opções, como iOS, Android, Web, etc.
- Introduza informações básicas na sua app, como o nome, o endereço de email e a categoria.
- Clique em Criar ID da app depois de introduzir as informações necessárias para gerar um identificador exclusivo para a sua app.
- 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.
- Configure a API Instagram Graph.
- Navegue para as definições da sua app.
- Adicione o produto API Instagram Graph à sua app através do painel de controlo.
- No painel de controlo da app, clique em Configurar abaixo de Instagram
- 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.
- 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.
- Associe a sua conta empresarial do Instagram.
- 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.
- Associe esta conta do Instagram a uma página do Facebook.
- Inicie sessão na Meta for Developers com as suas credenciais do Facebook.
- Clique no separador Apps e escolha a app Meta que criou no passo anterior.
- Clique em Definições da app > Básico no menu.
- 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.
- 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.
- Inicie sessão no Meta for Developers com as suas credenciais do Facebook.
- Clique no separador Apps e escolha a app Meta que criou no passo anterior.
- Clique em facebook Iniciar sessão > Definições no menu.
- Cole o URL de redirecionamento gerado em URIs de redirecionamento OAuth válidos no campo obrigatório.
- Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.
- Clique em + Criar novo para abrir a página Criar associação.
- Na secção Localização, escolha a localização para a ligação.
- 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.
- Clicar em Seguinte.
- Região: selecione uma localização na lista pendente.
- Na secção Detalhes da associação, conclua o seguinte:
- Conetor: selecione Instagram na lista pendente de conetores disponíveis.
- Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
- 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.
- Opcionalmente, introduza uma Descrição para a instância de associação.
- Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
- 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.
- 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).
- Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
- Clicar em Seguinte.
-
Na secção Autenticação, introduza os detalhes de autenticação.
- 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
- Clicar em Seguinte.
Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.
- Selecione um Tipo de autenticação e introduza os detalhes relevantes.
- Rever: reveja os detalhes da ligação e da autenticação.
- Clique em Criar.
-
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.
- Clique na associação necessária na página Associações.
É apresentada a página de detalhes da associação.
- Clique em Editar para editar os detalhes da associação.
- 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.
- Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
- Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
- Clique em Autorizar.
Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.
- 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.
- Clique em Autorização obrigatória.
É apresentado o painel Editar autorização.
- Copie o valor do URI de redirecionamento para a sua aplicação externa.
- Valide os detalhes da autorização.
- Clique em Autorizar.
Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligaçõ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
Entitiesestará 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
Actionsestá vazia. - Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione IGMedia na lista
Entity. - Selecione a operação
Liste, de seguida, clique em Concluído. - Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione AccountFollowersNonfollowers na lista
Entity. - Selecione a operação
Liste, de seguida, clique em Concluído. - 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. - Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione IGMedia na lista
Entity. - Selecione a operação
Gete, de seguida, clique em Concluído. - 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
18008309540391873no campo Valor de entrada e escolha EntityId como variável local. - Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione MediaInsightReels na lista
Entity. - Selecione a operação
Liste, de seguida, clique em Concluído. - 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. - Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione Comentários na lista
Entity. - Selecione a operação
Deletee, de seguida, clique em Concluído. - 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
18435078259055638no campo Valor de entrada e escolha EntityId como variável local. - Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione Comentários na lista
Entity. - Selecione a operação
Createe, de seguida, clique em Concluído. - Na secção Mapeador de dados da Tarefa, clique no editor
OpenDataMappinge, de seguida, introduza um valor semelhante ao seguinte emfield:{ "MediaId": "18008309540391873", "Text": "The Universe is with you" }
A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída
connectorOutputPayloadda tarefa do conetor:{ "Id": "18351045133102133" }
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione Respostas na lista
Entity. - Selecione a operação
Createe, de seguida, clique em Concluído. - Na secção Mapeador de dados da Tarefa, clique no editor
OpenDataMappinge, de seguida, introduza um valor semelhante ao seguinte emfield:{ "CommentId": "18022630739158714", "Text": "conquered" }
A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída
connectorOutputPayloadda tarefa do conetor:{ "Id": "18167970637306971" }
- 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.
- Compreenda como suspender e retomar uma associação.
- Compreenda como monitorizar a utilização do conector.
- Compreenda como ver os registos do conetor.
Para obter informações sobre como criar uma app, consulte o artigo Crie uma app.
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.
Configure a autenticação de cliente OAuth 2.0
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
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:
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 | |
| 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.
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:
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:
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.
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
Exemplo: listar todos os AccountFollowersNonfollowers
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
Exemplo: obtenha MediaInsightReels
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
Exemplo: criar um comentário
Exemplo: criar uma resposta
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.