A biblioteca de cliente .NET
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A biblioteca de cliente .NET está hospedada no GitHub 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 .NET Frameworks:
- .NET Framework 4.7.2+ (
net472)
- .NET Standard 2.1 (
netstandard2.1)
- .NET 6.0 (
net6.0)
- .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.
Acesse https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-1
para saber mais sobre a compatibilidade com o padrão .NET.
A biblioteca .NET da API Google Ads usa Grpc.Net.Client como padrão, com um
fallback para Grpc.Core em plataformas não compatíveis. É possível forçar o uso de
Grpc.Core definindo UseGrpcCore como true. Consulte
Usar a biblioteca Grpc legada.
Para começar a usar essa biblioteca, confira os
pré-requisitos e consulte o
guia de primeiros passos.
Para informações sobre tokens de atualização do OAuth2, confira Fluxos de aplicativos da Web e de
computador do OAuth. Para fazer chamadas de API usando contas de serviço do OAuth2, consulte Fluxo de conta de serviço do OAuth.
Consulte os guias a seguir para conhecer os recursos e utilitários da biblioteca:
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-26 UTC.
[null,null,["Última atualização 2025-08-26 UTC."],[[["\u003cp\u003eThe Google Ads API client library for .NET will no longer support .NET 5.0 starting with version 19.0.0, and users should upgrade to a supported version before the end of 2024.\u003c/p\u003e\n"],["\u003cp\u003eThe library supports .NET Framework 4.7.2+, .NET Standard 2.1, .NET 6.0, and .NET 8.0.\u003c/p\u003e\n"],["\u003cp\u003eIt is available as a NuGet package and hosted on GitHub, providing features for easier credential management and service client creation.\u003c/p\u003e\n"],["\u003cp\u003eWhile .NET Standard 2.1 offers compatibility with various .NET versions and implementations, only the explicitly listed frameworks are officially supported.\u003c/p\u003e\n"],["\u003cp\u003eUsers can find comprehensive documentation and guides, covering setup, OAuth flows, logging, and advanced features on the official Google Ads API website.\u003c/p\u003e\n"]]],[],null,["# The .NET Client Library\n\nThe .NET client library is [hosted on GitHub](https://github.com/googleads/google-ads-dotnet) and is distributed\nas a [NuGet package](//www.nuget.org/packages/Google.Ads.GoogleAds/). It\noffers several features to help you use the API, including easier management\nof credentials and creation of Google Ads API service clients.\n\nThe library supports the following .NET Frameworks:\n\n- .NET Framework 4.7.2+ (`net472`)\n- .NET Standard 2.1 (`netstandard2.1`)\n- .NET 6.0 (`net6.0`)\n- .NET 8.0 (`net8.0`)\n\n.NET Standard 2.1 is compatible with several other .NET versions and\nimplementations, so the library might work fine on many other platforms.\nHowever, we haven't officially tested the compatibility and thus don't\nofficially support these platforms.\nSee https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-1\nto learn more about .NET standard compatibility.\n\nThe Google Ads API .NET library uses `Grpc.Net.Client` as the default, with a\nfallback to `Grpc.Core` on unsupported platforms. You can force the use of\n`Grpc.Core` by setting `UseGrpcCore` to `true`. See\n[Use the legacy Grpc library](/google-ads/api/docs/client-libs/dotnet/getting-started).\n\nTo start using this library, check the\n[prerequisites](/google-ads/api/docs/get-started/introduction) and consult the\n[getting started guide](/google-ads/api/docs/client-libs/dotnet/getting-started).\n\nFor information on OAuth2 refresh tokens, check out [OAuth desktop and web\napplication flows](/google-ads/api/docs/client-libs/dotnet/oauth-web). And to make API calls\nusing OAuth2 service accounts, see [OAuth service account\nflow](/google-ads/api/docs/client-libs/dotnet/oauth-service).\n\nConsult the following guides for the library's features and utilities:\n\n- [Logging](/google-ads/api/docs/client-libs/dotnet/logging)\n- [FieldMasks](/google-ads/api/docs/client-libs/dotnet/field-masks)\n- [ResourceNames](/google-ads/api/docs/client-libs/dotnet/resource-names)\n- [Custom gRPC interceptors](/google-ads/api/docs/client-libs/dotnet/custom-interceptors)\n- [Protocol buffer types](/google-ads/api/docs/client-libs/dotnet/working-with-protobuf)"]]
