La biblioteca cliente de .NET está alojada 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 la biblioteca podría funcionar 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 .NET de la API de Google Ads usa Grpc.Net.Client como la capa de transporte predeterminada, con un resguardo a 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 dejó de estar disponible y solo está destinado al mantenimiento heredado. Consulta la
guía de uso básico para obtener más información.
Realiza tu primera llamada a la API
Para usar la API de Google Ads, debes realizar varios pasos para obtener acceso a la API y configurar tus cuentas de Google Ads. Sigue la guía de inicio rápido, que te guiará por todos los pasos importantes, incluida la configuración de tus cuentas de Google Ads.
Uso básico
Inicializa GoogleAdsClient con tu configuración y recupera un cliente de servicio para realizar llamadas a la API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.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 inyecció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. Si necesitas modificar
el comportamiento de registro de la biblioteca cliente, consulta la
guía del interceptor gRPC personalizado.
Utilidades
La biblioteca cliente de .NET incluye clases de utilidad para mejorar la usabilidad de la API, incluidos los 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 de rendimiento para obtener recomendaciones sobre cómo ajustar el rendimiento de tu aplicación.