FACEBOOK e INSTAGRAM.
Cada operação chama o endpoint REST de anúncios correspondente e retorna sua resposta sem alterações. Autenticação e limites são os mesmos do REST. Uma chamada com falha retorna um erro GraphQL: extensions.status traz o status do REST, e extensions.code traz o código de erro da Ayrshare quando o erro REST tiver um. Veja Erros. As operações de anúncios exigem o complemento Ads. Sem ele, toda chamada retorna um erro com extensions.status 403 e extensions.code 399.
Operações
Toda operação também aceita um
profileKey opcional para agir em nome de um User Profile (perfil de usuário). Todas retornam a resposta REST como JSON, então não aceitam seleção de campos.
Listar contas de anúncios
Comece por aqui. Use os valores deaccountId da resposta sempre que uma operação pedir accountId.
Buscar opções de segmentação
kind define a busca: INTERESTS para segmentação de público, REGIONS ou CITIES para localizações. Cada tipo aceita apenas seus próprios argumentos. Por exemplo, countryCode e regionId funcionam apenas com CITIES, e INTERESTS exige search.
Listar anúncios
Informe pelo menos um entrecampaignId, accountId, adId, postId ou socialPostId. socialPostId é o id da publicação na própria rede, para publicações que não foram feitas via Ayrshare.
Ver quanto um anúncio custou
Pausar ou retomar um anúncio
updateAd altera o gasto real com anúncios. PAUSED interrompe o gasto, ACTIVE o retoma, e DELETED ou ARCHIVED encerra o anúncio. O mesmo status também é aplicado ao conjunto de anúncios e à campanha do anúncio, então quaisquer outros anúncios nesse conjunto de anúncios ou campanha mudam junto.
As operações por plataforma, como
facebookAdAccounts e instagramAds, continuam funcionando e não foram alteradas.