APIs de mídia social cresceram muito desde que o Google lançou a primeira versão de sua API do YouTube em maio de 2008, e desde que o Facebook lançou a primeira versão de sua API Graph em abril de 2010. Hoje, essas APIs oferecem a oportunidade de pesquisar plataformas de mídia social: postagens, usuários, canais e dados demográficos. Eles também permitem que você crie seu próprio serviço ou aprenda mais sobre sua base de usuários.
Neste artigo, vamos examinar as maneiras como podemos usar algumas das populares APIs de mídia social:
- Facebook (API gráfica e marketing)
- Youtube
Também discutiremos suas limitações e exploraremos algumas de suas ferramentas mais úteis que estão disponíveis com essas APIs. Então, no artigo, daremos uma olhada em como integrar essas APIs em qualquer aplicativo de Trilhos .
Use uma API de rede social para conhecer seus usuários melhor do que eles próprios ' Tweet
Vou me concentrar na API de uma rede social por vez, para explicar seus recursos, limitações e ferramentas disponíveis. Haverá uma matriz com as diferentes APIs e suas propriedades para uma melhor comparação posteriormente neste artigo.
Antes de usar as APIs, você deve primeiro instalar um aplicativo que crie perguntas em nome de seu aplicativo com solicitações baseadas em OAuth. Os usuários irão autenticar suas informações em seu aplicativo e, após isso, você poderá ter acesso aos seus dados com o identificador de acesso do usuário resultante.
O FQL (Facebook Query Language) desatualizado usado para uma linguagem de consulta semelhante ao SQL, que poderia ser usado para acessar todos os dados do Facebook.
O Facebook lançou a primeira versão de sua API Graph em abril de 2010. A versão mais recente, no momento da redação deste artigo, é 2.6, que foi introduzida em 12 de abril de 2016. É uma API baseada em HTTP de baixo nível. Que pode ser usada para peça dados, crie posts e até crie campanhas publicitárias automatizadas.
Ferramentas
o API Graph Explorer é a ferramenta mais comumente usada ao trabalhar com a API do Facebook. Ele permite que você execute as perguntas da API Graph no mecanismo de pesquisa, bem como examine os resultados: você pode usar um dos blocos de acesso de seu aplicativo ou criar um instantaneamente com escopos selecionados.
Habilidades
A Graph API é uma API baseada em REST que permite criar, atualizar e excluir objetos de cada solicitação HTTP em alguns nós.
Token de acesso
Para fazer perguntas à API Graph, você precisa de um token de acesso que é obtido assim que um usuário autoriza seu aplicativo com sucesso.
Scopes
Os escopos determinam quais ações podem ser executadas em nome do usuário. O aplicativo solicita determinados escopos quando um usuário autoriza em um aplicativo. O escopo publish_actions, por exemplo, permite que um aplicativo publique postagens de um usuário. O escopo do email permite que o aplicativo leia o email do usuário. Uma revisão completa de todos os escopos pode ser encontrada em a documentação om .
Certos escopos, como publish_actions ou ads_management exigem uma revisão do Facebook antes do lançamento do aplicativo.
Exemplo
Para demonstrar como funciona a API Graph, mostrarei como criar, atualizar e excluir postagens com a API.
Para obter suas próprias postagens, você pode executar a pergunta GET /me/posts. O resultado será uma string JSON com uma lista de postagens, incluindo sua mensagem, created_time e id. Você pode usar o parâmetro pretty ou um Formatador JSON para que a resposta não pareça tão confusa.
Para obter mais dados sobre suas postagens, você pode estender a pergunta com campos como parâmetros de pergunta. Por exemplo, a pergunta me/posts?fields=reactions, picture ele vai te dar a foto e as reações da postagem.
Para criar uma postagem, você pode enviar uma ação POST para alimentação de borda , por exemplo. me/feed, com parâmetros como message: hello world. A API Graph retornará um objeto JSON com o ID da postagem que você criou. Você pode ver a postagem no endereço http://facebook.com/[post_id].
Para atualizar uma postagem, você pode enviar uma solicitação POST ao nó da postagem com os campos a serem atualizados como parâmetros; por exemplo, /[post_id] e parâmetros como Message: lorem ipsum. Um indicador de sucesso com um valor verdadeiro ou falso será retornado.
Para excluir uma postagem, você pode simplesmente fazer uma solicitação DELETE ao nó com o ID da postagem (por exemplo, /[post_id]). O valor de retorno será um objeto JSON com um valor de sucesso verdadeiro ou falso.
para que serve o scala
Uma revisão completa de todos os nós e ações está disponível no Referência de gráfico API .
API de marketing
o API de marketing merece uma menção especial, pois é uma das ferramentas de gerenciamento de publicidade mais poderosas do Facebook e obtém uma visão privilegiada da publicidade, por meio de seu aplicativo.
Funciona da mesma forma que outros métodos da API Graph. No entanto, você precisa do escopo ads_management para obter acesso aos anúncios do usuário. O Facebook também precisa revisar seu aplicativo antes que você possa publicá-lo.
Teste
Depois de criar seu aplicativo, ele está no modo de desenvolvimento e se torna automaticamente visível no painel do aplicativo (por exemplo, https://developers.facebook.com/apps/).
No modo de desenvolvimento, apenas administradores, desenvolvedores e testadores têm acesso ao seu aplicativo. Você pode adicionar testadores e administradores e a seção de funções do painel do seu aplicativo.
Processo de revisão
Quando certas permissões são adicionadas, o Facebook precisa revisar seu aplicativo antes que você possa publicá-lo. O processo de revisão é definido por este conjunto de guias .
Para inserir determinados itens para revisão, você só precisa adicioná-los à seção de revisão do painel do seu aplicativo. O Facebook irá guiá-lo através do processo de revisão e alertá-lo assim que seu aplicativo for aprovado.
Limitações e métodos alternativos
Limites de taxa
Um aplicativo pode fazer 200 chamadas por hora para cada usuário no total. Se você atingir esse limite, suas chamadas de API resultarão em um erro.
Pesquisando Postagens no Facebook
O Facebook restringe a pesquisa de postagens e tags no Facebook por meio da API Graph e FQL. No entanto, você pode usar o API Google Search para pesquisar postagens públicas no Facebook e, em seguida, usar o post-id na URL para obter mais informações sobre postagens específicas por meio da API Graph.
Obtenha dados de público personalizados
Percepçao publica no Facebook é uma ferramenta de pesquisa importante para aprender mais sobre um público com base em interesses, dados demográficos ou outros atributos (por exemplo, uma coleção de endereços de e-mail).
No entanto, não encontrei uma maneira de criar automaticamente uma percepção do público por meio da API de publicidade. Deixe-nos saber nos comentários se você tem alguma idéia criativa ou sugestão para isso.
o API Instagram Foi lançado em abril de 2014 e permite que você crie aplicativos que analisam as postagens dos usuários e os ajudam a gerenciar suas próprias postagens.
Ferramentas
Como o console da API do Instagram foi removido no momento da redação deste artigo, recomendo usar Apigee com o propósito de testá-lo em seu navegador.
as empresas podem alcançar crescimento principalmente por
Habilidades
A API do Instagram é uma API baseada em REST. Tudo dele pontos de saída são descritos em sua documentação oficial.
Token de acesso
Para fazer as perguntas à API do Instagram, você precisa de um token de acesso que é obtido assim que o usuário autoriza em sua aplicação. Para que um usuário receba um token de acesso, ele deve ser direcionado ao URL de autorização do seu aplicativo. O servidor irá redirecionar o usuário após autorizar seu aplicativo e mais tarde você pode ler o token.
Scopes
Seu aplicativo pode perguntar permitem diferente Por exemplo, 'básico' limita a leitura de informações de perfil, bem como fotos e imagens de um usuário. 'Public_content' permite que você leia qualquer perfil público e material multimídia em nome de um usuário.
Exemplos
Para demonstrar como a API do Instagram funciona, mostrarei exemplos baseados no ponto de saída de mídia https://api.instagram.com/v1/media/popular.
Este ponto de saída retorna a mídia popular atual do Instagram, se um bloco de acesso for passado como parâmetro. O resultado será uma cadeia de posts JSON que contém, para cada um, sua identificação multimídia, um link para sua imagem, gostos , comentários, o usuário que postou e alguns outros atributos.
Você pode usar apigeu para testar e descobrir mais sobre os pontos de saída da API e seus parâmetros.
Testes
Cada novo aplicativo que foi criado na plataforma Instagram começa em modo caixa de areia . Este é um ambiente totalmente funcional que permite que você teste os pontos de saída da API disponíveis publicamente, antes de enviar seu aplicativo para revisão.
Para testar seu aplicativo, você só precisa criar uma versão em estágios e executar todas as perguntas por meio dessa versão, em vez da versão ao vivo que passou pela revisão.
Processo de revisão
Apps em modo caixa de areia Você pode usar qualquer ponto de saída da API, mas eles são restritos a um número limitado de usuários e mídia. É um ótimo mecanismo para desenvolver e testar um aplicativo.
Para lançar ao vivo e acessar todo o conteúdo do Instagram, você precisará passar seu aplicativo por um Reveja . Depois de revisado, você só pode solicitar escopos para usuários para os quais seu aplicativo foi aprovado.
Limitações e métodos alternativos
Análise Demográfica
No momento em que este artigo foi escrito, não havia como obter informações sobre a idade, sexo ou interesses de um usuário público, porque o Instagram não fornece essas informações.
Para obter os dados demográficos dos seguidores ou uma lista de usuários do Instagram, você precisaria iterar cada um deles e tentar determinar sua idade e sexo, com base em seus seguidores ou nas informações em suas biografias.
Uma ótima solução de dados para esse problema pode ser um serviço muito valioso para algumas empresas.
Limites de taxa
Todos os limites de taxa na plataforma Instagram eles são controlados por um bloco de acesso em uma janela deslizante de 1 hora. Apps Live têm limites de taxa mais altos do que apps Mode Caixa de areia . O limite de taxa global para um aplicativo ao vivo é atualmente de 5.000 chamadas por hora.
A API do Twitter era liberado em setembro de 2006. É um API REST pública que fornece acesso de leitura e gravação aos dados do Twitter. A autenticação é feita usando OAuth. As respostas estão no formato JSON.
Ferramentas
O Twitter tem um Ferramenta de console API dirigido apigeu , que pode ser usado para testar solicitações no mecanismo de pesquisa.
Habilidades
A API REST permite obter tweets, seguidores e pessoas que um usuário segue. Você também pode encontrar as tags em outros tweets.
Token de acesso
O Twitter permite que você crie aplicativos que os usuários podem autenticar após o retorno do token de acesso. O modelo de autenticação é OAuth.
apple pay para usuários do Android
Scopes
Existem apenas duas permissões que precisam ser definidas na página de configurações do aplicativo: Somente leitura e Leitura e gravação. O último permite criar tweets e realizar outras ações nas postagens do usuário.
Exemplos
Para demonstrar o uso da API do Twitter, vou pegar os tweets autorizados do usuário. O resultado é uma string de caracteres JSON com as imagens, favoritos, retweets, urls, data de criação e outros atributos dos tweets. Usar Apigee para testar e descobrir mais sobre os pontos de saída da API e seus parâmetros.
Processo de Teste e Revisão
Atualmente não há processo de revisão ou modo de teste disponível para a API do Twitter.
Limitações e métodos alternativos
Análise Demográfica
Atualmente, não há uma maneira fácil de obter dados demográficos dos seguidores de um usuário no Twitter. A abordagem de força bruta seria revisar cada seguidor e tentar obter os dados por meio de suas biografias e relatos associados de outras redes sociais.
Posteriormente, você pode fazer suposições com base nos dados coletados dos seguidores por meio da análise de dados. Outra maneira de obter mais informações é por meio da plataforma de API de projeto pago do Twitter, chamada GNIP . Entre outras coisas, permite que você crie um público e obtenha mais informações sobre eles por meio da API. A API está atualmente em estado BETA.
Limites de taxa
Twitter tem limites de taxa para cada usuário e em uma base de 15 minutos. Se seu aplicativo tem vários tokens, você pode alternar tokens para operações públicas para evitar atingir o limite.
Youtube
A API de dados do YouTube foi lançada em janeiro de 2013. Ela permite adicionar recursos do YouTube ao seu aplicativo, pesquisar conteúdo e analisar dados demográficos de canais do YouTube. É um OAuth, a API REST baseada em token, que retorna respostas JSON.
Ferramentas
o Explorador de API permite que você teste solicitações não autorizadas, bem como autorizadas. Você pode executar solicitações de seu navegador para os pontos de saída fornecidos.
Habilidades
Entre outras coisas, você pode trabalhar com atividades, chats, transmissões ao vivo, canais, vídeos e assinaturas. A maioria dos pontos de saída exige uma autorização com uma conta do YouTube.
Token de acesso
A API de dados do YouTube oferece suporte ao protocolo OAuth 2.0 para autorizar acesso aos dados privados do usuário. Depois que um usuário for autorizado em seu aplicativo, ele será redirecionado para seu aplicativo, onde o token de acesso deve ser armazenado.
Para usar a autorização OAuth 2.0, você primeiro precisa obter credenciais de autorização do console de desenvolvedor do Google.
Scopes
A API de dados do YouTube atualmente funciona com os seguintes escopos:
- Força SSL - Gerencie sua conta do YouTube, mas apenas com uma conexão SSL.
- Por padrão - Gerencie sua conta do YouTube. Este escopo é funcionalmente idêntico ao escopo youtube.force-ssl, mas não requer uma conexão SSL.
- Somente leitura - Olhe para sua conta do YouTube.
- Suba - Envie vídeos para o YouTube e gerencie seus vídeos do YouTube.
- Auditar um canal amigo - Remove informações usadas por Redes Multicanal como critério para aceitar ou rejeitar um canal em sua rede.
Exemplos
Como exemplo do uso da API de dados do YouTube, mostro as seguintes perguntas de solicitação para vídeos com “codificação” no título e na descrição:
https://www.googleapis.com/youtube/v3/search?part=snippet&q=coding&key={YOUR_API_KEY} O resultado é um objeto JSON que contém o título, a descrição, videold e channelld. Você pode usar o último desses para aprender mais sobre o canal.
O parâmetro part necessário para qualquer solicitação de API retornada por alguma fonte. O parâmetro identifica as propriedades do recurso que devem ser incluídas em uma resposta da API. Por exemplo, um feed de vídeo tem as seguintes partes: snippet, contentDetails, fileDetails, player, processingDetails, recordingDetails, statistics, status, extensions, topicDetails.
O resto dos parâmetros, exceto a chave API, diferem em uma base chamada a chamada. Leia mais sobre isso no Guia de referência de API .
o API Pinterest Foi lançado inicialmente em abril de 2015. É uma API RESTful, que fornece acesso aos dados do usuário do Pinterest, como seus painéis, seguidores e muito mais. A API do Pinterest usa OAuth e permite permissões de leitura e gravação ao interagir com o conteúdo do usuário.
Ferramentas
Como os outros, o Pinterest fornece um API Explorer para testar seus pontos de saída e fazer perguntas a eles. Você pode ver suas ferramentas Aqui .
Habilidades
o API REST O Pinterest permite que você crie pins, painéis e faça perguntas sobre os dados do Pinterest com o OAuth.
Token de acesso
O Pinterest usa OAuth 2.0 para autenticar solicitações entre seu aplicativo e seus usuários. Todas as solicitações devem ser feitas por HTTPS.
Scopes
Os escopos determinam o que uma postagem pode fazer por um usuário. O Pinterest usa os seguintes escopos:
none(você deve saber o identificador) Use o método GET no perfil do usuário, detalhes do quadro e do PIN, e o PIN no quadro.read_public: Use o método GET no PIN do usuário, placa e gostos .write_public: Use os métodos PATCH, POST e DELETE nos pinos e placas do usuário.read_relationships: Use o método GET sobre os seguidores e quem o usuário segue (em fóruns, usuários e interesses).write_relationships: Use os métodos PATCH, POST e DELETE nos seguidores e quem o usuário segue (nos fóruns, usuários e interesses).
Exemplos
Para demonstrar o uso da API do Pinterest, vou demonstrar como ler os últimos pinos do usuário:
https://api.pinterest.com/v1/me/pins/?access_token={your_token}&fields=id,link,note,url,counts,board,created_at retornará os pinos do usuário com sua identificação, link, nota, url, gostos e repins.
Processo de Teste e Revisão
Os aplicativos estão inicialmente no modo de desenvolvimento e devem ser enviados para revisão antes de serem lançados no modo de produção.
Limitações e métodos alternativos
Análise Demográfica
Não há uma maneira comum de obter dados demográficos de um painel. No entanto, você pode tentar obter seus seguidores e informações da biografia nos fóruns, bem como links para outras contas de mídia social. Uma ótima solução de dados em conexões de usuários comuns também é uma possibilidade.
Pesquisa de alfinetes
Atualmente, não há como procurar pinos com determinadas tags ou palavras-chave por meio da API. Você pode contornar essa limitação usando a API de pesquisa personalizada do Google para pesquisar resultados apenas nos pinos do Pinterest e coletar a ID do pino por meio do URL. A identificação pode ser usada posteriormente para obter informações sobre o Pin por meio da API.
Limites de taxa
Cada aplicativo (com um ID de aplicativo exclusivo) pode receber 1.000 chamadas por ponto de saída por hora para cada token de usuário exclusivo.
Cada resposta da API retorna um cabeçalho que fornece uma atualização sobre os limites de taxa. Limite X-Ratelimit é o limite de taxa para essa solicitação específica e X-Ratelimit-Remaining é o número de solicitações que você deixou em uma janela de 60 minutos.
Se você exceder o limite da taxa para o ponto de saída fornecido, receberá um código de erro 429 “Muitos pedidos” .
Comparação de APIs de mídia social
| Versão | OAuth | Formato | Demografia | |
|---|---|---|---|---|
| v2.6 Lançamento inicial: abril de 2010 | OAuth 2 | Solicitações REST com respostas JSON | Com suporte | |
| v1 Lançamento inicial: abril de 2014 | OAuth 2 | Solicitações REST com respostas JSON | Não suportado | |
| v1.1 Lançamento inicial: setembro de 2006 | OAuth 1 | Solicitações REST com respostas JSON | Suportado apenas com GNIP | |
| Youtube | v3 Lançamento inicial: janeiro de 2013 | OAuth 2 | Solicitações REST com respostas JSON | Com suporte |
| v1 Lançamento inicial: abril de 2015 | OAuth 2 | Solicitações REST com respostas JSON | Não suportado |
Aplicativo de demonstração Lema
Ao integrar essas APIs em seus aplicativos novos ou existentes, graças a um excesso de pacotes e bibliotecas de API de mídia social, esse processo é mais fácil do que nunca. A maioria das plataformas e estruturas têm bibliotecas de terceiros comprovadas que até mesmo unificam o aspecto de autenticação de todas essas APIs em uma única biblioteca com uma arquitetura de plug-in elegante.
Para este artigo, veremos como Lema , uma joia do Ruby, faz isso muito elegantemente para aplicativos Rails. Lema é uma biblioteca de autenticação flexível baseada em Guardião que implementa autenticação, registro, acesso e armazenamento de dados para fornecer acesso múltiplo. Se você for uma pessoa mais inclinada ao front-end e quiser ver algo semelhante ao AngularJS, dê uma olhada este artigo .
Lema Como muitas bibliotecas desse tipo, elas ainda não foram criadas com suporte para qualquer uma das APIs de mídia social. O suporte para cada uma dessas APIs de mídia social é fornecido por meio de gemas adicionais. As seguintes gems estão disponíveis para autenticação Rails, cobrindo os cinco provedores discutidos neste artigo:
gem 'omniauth-facebook' gem 'omniauth-pinterest' gem 'omniauth-twitter' gem 'omniauth-google-oauth2' gem 'omniauth-instagram' Uma das melhores coisas sobre Rails é que existem muitos plugins escritos pela comunidade open source. Eles são distribuídos como gemas. Listadas em um arquivo de configuração central, essas joias são gerenciadas pelo Bundler.Como eles fornecem apenas autenticação, registro, acesso e armazenamento para cada um desses provedores, também precisaremos obter os seguintes gems para os clientes de API:
gem 'twitter' # https://github.com/sferik/twitter gem 'instagram' # https://github.com/facebookarchive/instagram-ruby-gem gem 'koala' # (Facebook API) https://github.com/arsduo/koala gem 'google-api-client' # (YouTube API), https://github.com/google/google-api-ruby-client gem 'pinterest-api' # https://github.com/realadeel/pinterest-api Omniauth e autenticação
Para que um usuário possa autorizar seu aplicativo com seu provedor, você pode fornecer um link com o seguinte caminho:
omniauth_authorize_path('user', :facebook) omniauth_authorize_path('user', :instagram) ... Para poder reagir à chamada após a autenticação de um usuário, você pode definir um OmniauthCallbacksController com escopos como funções como estas:
class AuthenticationsController Esse é o lugar para adicionar um novo modelo de autenticação com o token e os dados em seu aplicativo:
authentication = where(provider: omniauth.provider, user_id: user.id) .first_or_create do |auth| auth.user = user auth.uid = omniauth.uid auth.secret = omniauth.credentials.secret auth.token = omniauth.credentials.token ... end Faça chamadas de API
Aqui está um exemplo de como usar Coala para fazer perguntas à API do Facebook. O restante dos provedores funcionam mais ou menos de maneira semelhante e estão documentados no README da gema.
É assim que você obtém seus dados de usuário usando o Koala:
diferença entre c corp vs s corp
authentication = user.authentication_for_provider(:facebook) token = authentication.token api = Koala::Facebook::API.new(token) results = api.get_object('me') Você pode então usar o resultado de retorno JSON feito pela API. O código-fonte para esta demonstração de aplicativo é disponível no GitHub .
Para finalizar
As APIs de mídia social fornecem uma ferramenta poderosa para fazer perguntas sobre o conjunto de dados em grande escala da mídia social, bem como coletar big data para seu aplicativo. Você pode construir um serviço com base nessas APIs ou usá-las para aumentar seu próprio aplicativo ou insights do usuário.
Rails e as gemas disponíveis tornam mais fácil integrar essas APIs em seu aplicativo Rails e consultar as interfaces com uma camada de abstração entre seu aplicativo e a API.
