Graph API do Instagram

Colaboradores

Representa a lista de usuários que são adicionados como colaboradores em um objeto de mídia do Instagram.

Criação

Esta operação não é compatível.

Leitura

Obtenha a lista de usuários colaboradores e o status dos respectivos convites em um objeto de mídia do Instagram.

GET /{ig-media-id}

Limitações

  • Até 3 contas do Instagram podem ser adicionadas como colaboradores.
  • Somente usuários do Instagram que habilitaram a marcação como colaborador serão retornados na resposta.
  • A marcação de colaboradores pode ser feita em imagens, reels e carrosséis no Feed. Os Stories não são compatíveis.

Requisitos

TipoDescrição

Tokens de acesso

Usuário: o usuário precisa ter criado o objeto de mídia do Instagram

Permissões

instagram_basic
pages_read_engagement
pages_show_list


Caso uma função na Página tenha sido concedida ao usuário do app por meio do Gerenciador de Negócios, você também precisará obter uma destas permissões:


ads_management
business_management

Sintaxe da solicitação

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

Exemplo de resposta

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

Parâmetros de caminho

Espaço reservadoValor

{api-version}

A versão da API.

{ig-user-id}

Obrigatório. Número de identificação do usuário do Instagram.

Parâmetros da string de consulta

ChaveEspaço reservadoValor

access_token

{access-token}

Obrigatório. O token de acesso do usuário do app.

Campos de resposta

Nome do campoDescrição

id

O ID no escopo do app da conta do Instagram do possível colaborador

invite_status

O status do convite enviado ao possível colaborador. Pode ser:

  • Accepted
  • Declined
  • Pending

username

O nome de usuário do perfil do Instagram do possível colaborador

Atualização

Esta operação não é compatível.

Exclusão

Esta operação não é compatível.