Contêiner do Instagram

Representa um contêiner de mídia para publicar um objeto de mídia do Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

Criação

Esta operação não é aceita.

Leitura

GET <HOST_URL>/<IG_CONTAINER_ID>

Obtém campos e bordas em um contêiner do Instagram.

Sintaxe da solicitação

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parâmetros da string de consulta

ParâmetroValor

access_token
Obrigatório
String

O token de acesso do usuário do app.

fields
Lista separada por vírgulas

Uma lista separada por vírgulas dos campos e bordas que devem ser retornados. Se omitida, os campos-padrão serão retornados.

Campos

Nome do campoDescrição

copyright_check_status

Usado para verificar se o vídeo carregado viola direitos autorais. Estes são os pares chave-valor retornados:

  • matches_found definido como uma das opções a seguir.
    • true: o vídeo viola direitos autorais.
    • false: o vídeo não viola direitos autorais.
  • status definido como uma das opções a seguir.
    • completed: o processo de detecção foi concluído.
    • error: ocorreu um erro durante o processo de detecção.
    • in_progress: o processo de detecção está em andamento.
    • not_started: o processo de detecção não foi iniciado.

id

ID do contêiner do Instagram, representado em exemplos de código como <IG_CONTAINER_ID>.

status

Status de publicação. Se status_code for ERROR, esse valor será um subcódigo de erro.

status_code

O status de publicação do contêiner. Valores possíveis:


  • EXPIRED: o contêiner não foi publicado dentro de 24 horas e expirou.
  • ERROR: o processo de publicação do contêiner não foi concluído.
  • FINISHED: o contêiner e o objeto de mídia estão prontos para publicação.
  • IN_PROGRESS: o processo de publicação do contêiner está em andamento.
  • PUBLISHED: o objeto de mídia do contêiner foi publicado.

Bordas

Não há bordas nesse nó.

Resposta

Um objeto formatado por JSON que contém os campos solicitados e padrão.

{
  "<FIELD>":"<VALUE>",
  ...
}

Exemplo de solicitação

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

Exemplo de resposta

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Atualização

Esta operação não é aceita.

Exclusão

Esta operação não é aceita.