Guia do Explorador da Graph API

Usos comuns

• Gere tokens de acesso rapidamente.
• Obtenha exemplos de código para suas consultas.
• Gere informações de depuração para incluir em solicitações de suporte.
• Teste consultas de API com as configurações do app de produção, incluindo permissões, recursos e configurações para seus casos de uso.
• Teste consultas de API com seu app de teste ou em desenvolvimento usando permissões e recursos com usuários ou dados de teste.

Requisitos

• Uma conta de desenvolvedor do Facebook
• Um app no qual você tem uma função de administrador, desenvolvedor ou testador

Componentes

Token de acesso

Quando você obtém um token de acesso, ele é exibido no canto superior direito da ferramenta. Esse é o token incluído na sua consulta da Graph API. Você pode copiar o token e usá-lo no seu app para testar o código.

Clique no ícone de informações para ver detalhes sobre o token atual, incluindo o app ao qual ele está vinculado e as permissões concedidas pelo usuário (que é você).

Será possível gerar um novo token de acesso se o identificador tiver expirado ou se você adicionar novas permissões.

App da Meta

No canto superior direito, o menu suspenso App da Meta exibe todos os apps nos quais você tem uma função de administrador, desenvolvedor ou testador. Use esse menu para selecionar as configurações do app a ser testado.

Usuário ou Página

O menu suspenso Usuário ou Página permite obter e trocar tokens de acesso para apps, usuários e Páginas no app selecionado no momento. Você também pode usá-lo para desinstalar o app do seu nó de usuário, o que destrói o token de acesso atual.

Permissões

Sempre que você solicita um token de acesso do usuário, somente a permissão public_profile é concedida por padrão. O menu suspenso Permissão permite selecionar permissões de dados de usuário (como email e user_photos), eventos, grupos e Páginas (como manage_pages e ads_management) e outros tipos (como instagram_basic e publish_video). Isso permite que o usuário atual (ou seja, você) conceda ao app permissões específicas. Conceda somente permissões de que o app precisa.

Caso o app esteja em desenvolvimento, você poderá conceder a ele qualquer permissão, e as consultas respeitarão os dados pertencentes a pessoas com uma função no seu app. No entanto, se o app estiver publicado, conceder uma permissão para a qual o app não foi aprovado pelo processo de análise fará com que sua consulta falhe sempre que for enviada.

Campo da string de consulta

Ao entrar na ferramenta pela primeira vez, você verá uma consulta padrão. É possível editar a consulta digitando uma nova ou pesquisando e selecionando campos no visualizador após executá-la. Você também pode usar os menus suspensos para alternar entre métodos de operação e direcionar diferentes versões da Graph API.

Se você clicar no ícone de estrela no final do campo da consulta, ela será salva como favorita. É possível visualizar suas consultas favoritas clicando no ícone de livro.

Visualizador de campos de nó

Quando você envia uma consulta GET em um nó, o visualizador de campos localizado no lado esquerdo da janela exibe o nome do nó e os campos retornados pela Graph API. Para modificar a consulta, você pode pesquisar e selecionar novos campos, clicar no ícone de mais e escolher entre os campos disponíveis ou desmarcar os desnecessários. Essas ações atualizam a consulta de modo dinâmico no campo de strings de consulta.

Janela de resposta

A resposta, localizada abaixo da string de consulta, mostra os resultados retornados pela última consulta enviada.

Obter código

Se estiver tudo certo, clique no botão Obter código abaixo da resposta para gerar um exemplo de código com base na consulta. Normalmente, não é possível copiar e colar o exemplo de código diretamente na base do código, mas é um ponto de partida útil.

Copiar informações de depuração

Se a consulta falhar várias vezes por um motivo desconhecido, e você decidir entrar em contato com o Suporte ao desenvolvedor, clique neste botão (localizado na parte central inferior da página) para copiar a consulta e os detalhes da resposta para a área de transferência. Você pode enviar essas informações junto com a solicitação de suporte para nos ajudar a entender o que está acontecendo.

Salvar sessão

Clique no botão Salvar sessão, na parte central inferior da página, para salvar o estado da sua consulta, com o token de acesso removido. Inclua o link para a sessão se decidir entrar em contato com o Suporte ao desenvolvedor.

Exemplo de consulta

Tente executar a consulta padrão que é exibida ao carregar o Explorador da Graph API pela primeira vez. Se ainda não tiver feito isso, abra o Explorador da Graph API em uma nova janela, selecione o app que deseja testar no menu suspenso e obtenha um token de acesso de usuário.

A consulta padrão é exibida no campo de string da consulta:

GET https://developers.facebook.com/v21.0/me?fields=id,name

Essa consulta solicita os campos id e name do nó /me, que é especial e mapeia para o nó /User ou /Page identificado pelo token. Como você estará usando um token de acesso de usuário, o mapeamento será feito para o seu nó de usuário.

Os campos id e name estão disponíveis publicamente e podem ser retornados se o usuário tiver concedido ao app as permissões default ou public_profile. Essas permissões são pré-aprovadas para todos os apps. Você pode confirmar isso clicando no ícone de informações no campo Token de acesso. Por isso, não será necessário conceder permissões adicionais para que a consulta funcione. Clique em Obter token de acesso e confirme que deseja conceder acesso às informações de usuário disponíveis publicamente ao seu app.

Depois de enviar a consulta, você deverá ver seu nome e ID do usuário no escopo do app na janela de resposta.