Graph API do Instagram

Publicação de mídia do usuário do Instagram

Publica um contêiner do Instagram em um usuário do Instagram para Empresas. Consulte o guia Publicação de conteúdo para ver todas as etapas do processo.

Criação

POST /{ig-user-id}/media_publish

Publica um objeto de contêiner do Instagram em um usuário do Instagram para Empresas.

Limitações

  • Em um período de 24 horas, a API pode fazer no máximo 25 publicações por conta do Instagram.
  • Se a Página conectada à conta empresarial do Instagram em questão necessitar de autorização para publicação na Página (PPA, pelas iniciais em inglês), o processo de PPA deverá ser concluído para que a solicitação seja bem-sucedida.
  • Se a Página conectada à conta empresarial do Instagram em questão exigir autenticação de dois fatores, o usuário do Facebook também precisará ter realizado a autenticação de dois fatores ou ocorrerá uma falha na solicitação.
  • Não há compatibilidade com publicações no Instagram TV.

Requisitos

TipoDescrição

Tokens de acesso

Usuário

Funções na empresa

Se estiver publicando contêineres para a marcação de produtos, o usuário do aplicativo precisará ter uma função de administrador no Gerenciador de Negócios da Loja do Instagram.

Loja do Instagram

Se estiver publicando contêineres para a marcação de produtos, o usuário precisará ter uma Loja do Instagram aprovada com um catálogo que inclua produtos.

Permissões

instagram_basic
instagram_content_publish
pages_read_engagement ou pages_show_list


Caso uma função administrativa tenha sido concedida ao usuário do aplicativo por meio do Gerenciador de Negócios, você precisará obter uma das seguintes permissões:


ads_management
business_management


Se estiver publicando contêineres para marcação de produtos, você também precisará do seguinte:


catalog_management
instagram_shopping_tag_products

Tarefas

O usuário do aplicativo cujo token é usado na solicitação deve poder executar tarefas MANAGE ou CREATE_CONTENT na Página conectada à conta do Instagram em questão.

Sintaxe da solicitação

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media_publish
  ?creation_id={creation-id}
  &access_token={access-token}

Parâmetros de caminho

Espaço reservadoValor

{api-version}
String

A versão da API.

{ig-user-id}
Obrigatório
String

O ID do usuário no escopo do aplicativo.

Parâmetros da string de consulta

ChaveEspaço reservadoDescrição

access_token

Obrigatório

{access-token}

O token de acesso do usuário do aplicativo.

creation_id

Obrigatório

{creation-id}

O ID do contêiner do Instagram que será publicado.

Exemplo de solicitação

POST graph.facebook.com
  /17841405822304914/media_publish
    ?creation_id=17889455560051444

Exemplo de resposta

{
  "id": "17920238422030506"
}

Leitura

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

Atualização

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

Exclusão

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