Voltar para Notícias para desenvolvedores

Próxima alteração na obsolescência da versão da API de Marketing para habilitar a atualização automática

16 de abril de 2024PorMengxuan Zhang

Assinar o blog Notícias para desenvolvedores

Para oferecer uma experiência geral com a API de Marketing ainda mais integrada e eficiente, estamos felizes em anunciar o lançamento do recurso de atualização automática da versão. A partir de maio de 2024, habilitaremos o recurso de atualização automática da versão para os pontos de extremidade da API de Marketing que não forem afetados entre as versões. Isso significa que, entre uma versão prestes a ficar obsoleta e a próxima disponível, se nenhum ponto de extremidade for afetado, a plataforma atualizará automaticamente a chamada para a versão seguinte, em vez de apresentar falha na solicitação diretamente.

O controle de versões é um modo comum de lidar com as mudanças na API, geralmente usado para apresentar alterações disruptivas. À medida que novas versões são lançadas, as opções mais antigas ficam obsoletas. Durante a obsolescência da API, o app que chamar uma versão obsoleta receberá um erro "(#2635) Você está chamando uma versão obsoleta da API de Anúncios. Atualize para a versão mais recente: vXXX".

No dia 14 de maio de 2024, a v17.0 ficará obsoleta. De acordo com o registro de alterações da v18.0, os seguintes pontos de extremidade serão afetados:

POST /act_{ad-account-id}/reachfrequencypredictions
GET /act_{ad-account-id}/reachestimate
GET /act_{ad-account-id}/delivery_estimate
POST /act_{ad-account-id}/adsets
POST /{adset-id}
POST /act_{ad-account-id}/saved_audiences
POST /{saved-audience-id}
POST /act_{ad-account-id}/credit_cards

Caso seu app chame "POST /{adset-id}" com a v17.0 depois do dia 14 de maio de 2024, quando ela ficará obsoleta, essa solicitação de API falhará, já que a atualização automática não se aplica a pontos de extremidade afetados pela próxima versão disponível (v18.0).

Se o app chamar "GET /{ad-account-id}/insights" com a v17.0 depois que ela ficar obsoleta, a plataforma atualizará a chamada para a próxima versão disponível (v18.0).

Caso seu app já esteja fazendo chamadas com versões posteriores à v17.0, nada mudará após a data em que a versão ficar obsoleta.

Para desabilitar a atualização automática da versão, acesse Configurações > Configurações da versão da API de Anúncios no cartão de produto do app da API de Marketing e desabilite o recurso.

Para confirmar se uma chamada foi atualizada automaticamente, verifique o cabeçalho da resposta da API para obter mais detalhes.

Exemplo de cabeçalho da notificação: "Aviso da versão X da API de Anúncios: a chamada foi atualizada automaticamente para a v17.0, já que a v16.0 ficou obsoleta''.

Para saber mais sobre esse comportamento, consulte o controle de versões da API de Marketing.

Para verificar os pontos de extremidade afetados em cada versão, consulte nosso registro de alterações.

Pontos de extremidade afetados