Quinta-feira, 20 de fevereiro de 2025
O que está mudando?A partir da semana de 1º de maio de 2025, vamos lançar o desmembramento de consentimento para autenticação de usuários do OAuth em todos os projetos na nuvem do Google Cloud criados antes de 2019. Se você tem um aplicativo que usa uma API relacionada ao Google Ads em um projeto na nuvem do Google Cloud criado antes de 2019, talvez seja necessário atualizar o aplicativo para lidar com o consentimento do usuário desagregado antes de 1º de maio de 2025.
Contexto
Com o desmembramento do consentimento para o fluxo de autenticação de usuários do OAuth, os usuários podem personalizar os escopos específicos do OAuth que querem autorizar para o aplicativo, em vez de uma abordagem de tudo ou nada. Todos os projetos do console do Google Cloud criados desde 2019 têm esse recurso ativado, enquanto todos os projetos criados antes de 2019 têm esse recurso desativado.
Quem será afetado por essa mudança?
Você vai ser afetado por essa mudança se TODAS as condições a seguir forem atendidas:
- Seu aplicativo de API usa um projeto do console do Google Cloud criado antes de 2019.
- Seu aplicativo implementa o fluxo de consentimento do usuário do OAuth 2.0, um fluxo de trabalho de autenticação em que o usuário faz login com a Conta do Google e concede uma ou mais permissões solicitadas pelo aplicativo.
- Seu aplicativo usa mais de uma API do Google, e uma delas é uma API relacionada ao Google Ads listada abaixo.
Quem não será afetado por essa mudança?
- Tokens de atualização atuais: essa mudança não afeta as autenticações de usuários que você já tem. Os tokens de atualização atuais vão continuar funcionando sem mudanças ou reautenticação.
- Aplicativos de escopo único: se o aplicativo usa apenas um escopo de API do Google, ele não será afetado por essa mudança, já que não há vários escopos do OAuth para desagrupar.
- Aplicativos de usuário único / Aplicativos autenticados manualmente: seu aplicativo não tem um fluxo de autenticação de usuário do OAuth implementado. Em vez disso, use um script de autenticação manual, como GenerateUserCredentials, CLI gcloud ou OAuth Playground para autenticar o usuário e, em seguida, use essas credenciais por um longo período. Como você seleciona todos os escopos necessários para o aplicativo durante a autenticação, ele não é afetado por essa mudança.
- Contas de serviço: se o aplicativo usa uma conta de serviço para autenticar as chamadas de API, você não vai ser afetado por essa mudança.
O que preciso fazer?
É preciso garantir que o app possa lidar com o consentimento parcial do usuário. Para isso, criamos primeiro
- Solicite a lista de escopos do OAuth com que o usuário consentiu incluindo o parâmetro
include_granted_scopesno fluxo do OAuth. - Analise a lista real de escopos OAuth que o usuário consentiu na resposta do OAuth.
- Implemente a autorização incremental no seu aplicativo.
Consulte nosso guia de consentimento granular do OAuth para saber mais sobre os requisitos e as práticas recomendadas para lidar com o consentimento granular.
Como faço para testar esse recurso?
Há duas maneiras de testar esse recurso:
- Crie um novo projeto do Google Cloud: os novos projetos do Google Cloud têm a separação do consentimento do OAuth ativada. Portanto, é possível criar um projeto do Google Cloud e usá-lo para testar o aplicativo.
- Ativar o consentimento desagregado no seu projeto: defina o parâmetro
enable_granular_consentcomo verdadeiro na solicitação de autorização do OAuth.
Quais escopos de API são afetados?
As seguintes APIs relacionadas ao Google Ads são afetadas por essa mudança.
Como receber ajuda
Se tiver dúvidas ou precisar de ajuda, entre em contato com a equipe de suporte da API em questão.
- Anash P. , equipe da API Google Ads
Rótulos: authentication, oauth