A biblioteca de cliente .NET é hospedada no GitHub (link em inglês) e distribuída como um pacote NuGet. Ela oferece vários recursos para ajudar você a usar a API, incluindo gerenciamento mais fácil de credenciais e criação de clientes de serviço da API Google Ads.
A biblioteca é compatível com os seguintes frameworks .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, então 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 sem suporte. É possível forçar o uso de Grpc.Core definindo UseGrpcCore como true, mas Grpc.Core está descontinuado e destinado 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 acessar a API e configurar suas contas do Google Ads. Siga o guia de início rápido, que explica todas as etapas importantes, incluindo a configuração das suas contas do Google Ads.
Uso básico
Inicialize GoogleAdsClient com suas configurações de configuração e extraia um
cliente de serviço para fazer chamadas de API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.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
de computador e da Web), contas de serviço, credenciais padrão do aplicativo (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 geração de registros
A biblioteca de cliente do .NET oferece suporte a várias opções de configuração
e registro em log usando objetos de tempo de execução, arquivos App.config,
arquivos de configuração JSON ou variáveis de ambiente. Se você precisar modificar
o comportamento de geração de registros da biblioteca de cliente, consulte o
guia de interceptor gRPC personalizado.
Utilitários
A biblioteca de cliente .NET inclui classes utilitárias para melhorar a usabilidade da API,
incluindo helpers de upload de mídia e vídeo (UploadVideo em 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 performance para recomendações sobre como ajustar a performance do seu aplicativo.