La biblioteca cliente de .NET se aloja en GitHub y se distribuye como un paquete NuGet. Ofrece varias funciones para ayudarte a usar la API, incluida una administración más sencilla de las credenciales y la creación de clientes de servicio de la API de Google Ads.
La biblioteca admite los siguientes frameworks de .NET:
- .NET Framework 4.7.2 y versiones posteriores (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1 es compatible con varias otras versiones e implementaciones de .NET, por lo que es posible que la biblioteca funcione bien en muchas otras plataformas. Sin embargo, no probamos oficialmente la compatibilidad y, por lo tanto, no admitimos oficialmente estas plataformas. Consulta la documentación de.NET Standard 2.1 para obtener más información.
La biblioteca de la API de Google Ads para .NET usa Grpc.Net.Client como la capa de transporte predeterminada, con un resguardo de Grpc.Core en plataformas no compatibles. Si bien puedes forzar el uso de Grpc.Core configurando UseGrpcCore como true, ten en cuenta que Grpc.Core está en desuso y solo se destina al mantenimiento de sistemas heredados. Consulta la guía de uso básica para obtener más información.
Realiza tu primera llamada a la API
Para usar la API de Google Ads, debes seguir varios pasos para obtener acceso a ella y configurar tus cuentas de Google Ads. Sigue la guía de inicio rápido, que te explica todos los pasos importantes, incluida la configuración de tus cuentas de Google Ads.
Uso básico
Inicializa GoogleAdsClient con la configuración y recupera un cliente de servicio para realizar llamadas a la API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
Consulta la guía de uso básico para obtener más información sobre cómo usar la biblioteca cliente de .NET.
Autorización y autenticación
La biblioteca cliente de .NET admite varios enfoques para la autenticación y la autorización, incluidas las credenciales de usuario de OAuth 2.0 (para aplicaciones web y de escritorio), las cuentas de servicio, las credenciales predeterminadas de la aplicación (v24.1.0 y versiones posteriores) y la inserción manual de credenciales (v27.0.0 y versiones posteriores). Consulta la guía de autorización y autenticación para obtener más información.
Configuración y registro
La biblioteca cliente de .NET admite varias opciones de configuración y registro con objetos de tiempo de ejecución, archivos App.config, archivos de configuración JSON o variables de entorno. En caso de que necesites modificar el comportamiento de registro de la biblioteca cliente, consulta la guía del interceptor personalizado de gRPC.
Utilidades
La biblioteca cliente de .NET incluye clases de utilidad para mejorar la usabilidad de la API, incluidos asistentes para la carga de contenido multimedia y video (UploadVideo en v27.2.0 y versiones posteriores).
Consulta las siguientes guías para obtener más información:
Ajusta el rendimiento de tu aplicación
Consulta la guía de ajuste del rendimiento para obtener recomendaciones sobre cómo ajustar el rendimiento de tu aplicación.