A biblioteca de cliente .NET é hospedada no GitHub e distribuída como um pacote NuGet. Ela oferece vários recursos para ajudar você a usar a API, incluindo o gerenciamento mais fácil de credenciais e a criação de clientes de serviço da API Google Ads.
A biblioteca oferece suporte a estas estruturas do .NET:
- .NET Framework 4.7.2 e versões mais recentes (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
O .NET Standard 2.1 é compatível com várias outras versões e implementações do .NET. Portanto, a biblioteca pode funcionar bem em muitas outras plataformas. No entanto, não testamos oficialmente a compatibilidade e, portanto, não oferecemos suporte oficial a essas plataformas. Consulte a documentação do.NET Standard 2.1 para saber mais.
A biblioteca .NET da API Google Ads usa Grpc.Net.Client como a camada de transporte padrão, com um fallback para Grpc.Core em plataformas não compatíveis. Embora seja possível forçar o uso de Grpc.Core definindo UseGrpcCore como true, observe que Grpc.Core está obsoleta e destinada apenas à manutenção legada. Consulte o
guia de uso básico para saber mais.
Fazer sua primeira chamada de API
Para usar a API Google Ads, você precisa realizar várias etapas para ter acesso a ela e configurar suas contas do Google Ads. Siga o guia de início rápido, que orienta você em todas as etapas importantes, incluindo a configuração das suas contas do Google Ads.
Uso básico
Inicialize GoogleAdsClient com as configurações e recupere um cliente de serviço para fazer chamadas de API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
Consulte o guia de uso básico para saber mais sobre como usar a biblioteca de cliente .NET.
Autorização e autenticação
A biblioteca de cliente .NET oferece suporte a várias abordagens de autenticação e autorização, incluindo credenciais de usuário do OAuth 2.0 (para aplicativos da Web e para computador), contas de serviço, Application Default Credentials (v24.1.0 e versões mais recentes) e injeção manual de credenciais (v27.0.0 e versões mais recentes). Consulte o
guia de autorização e autenticação para saber mais.
Configuração e registro
A biblioteca de cliente .NET oferece suporte a várias opções de configuração
e registro usando objetos de ambiente de execução, arquivos App.config,
JSON de configuração ou variáveis de ambiente. Caso precise modificar
o comportamento de registro da biblioteca de cliente, consulte o
guia do interceptor gRPC personalizado.
Utilitários
A biblioteca de cliente .NET inclui classes de utilitários para melhorar a usabilidade da API, incluindo ajudantes de upload de mídia e vídeo (UploadVideo na v27.2.0 e versões mais recentes).
Consulte os guias a seguir para saber mais:
Ajustar o desempenho do aplicativo
Consulte o guia de ajuste de desempenho para conferir recomendações sobre como ajustar o desempenho do aplicativo.