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 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 las 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 se usa para el mantenimiento heredado. Consulta la
guía de uso básico para obtener más información.
Instalación
Instala el paquete NuGet Google.Ads.GoogleAds en tu
proyecto con la herramienta de línea de comandos de dotnet:
dotnet add package Google.Ads.GoogleAds
Para cargar los parámetros de configuración desde appsettings.json, App.config o
variables de entorno, también instala el
paquete Google.Ads.GoogleAds.Extensions:
dotnet add package Google.Ads.GoogleAds.Extensions
Realiza tu primera llamada a la API
Para usar la API de Google Ads, debes seguir 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 GoogleAdsConfig y GoogleAdsClient con tus parámetros de configuración, recupera GoogleAdsServiceClient y transmite filas de campañas con SearchStream:
using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;
GoogleAdsConfig config = new GoogleAdsConfig()
{
OAuth2Mode = OAuth2Flow.APPLICATION,
OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};
GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
"SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";
try
{
googleAdsService.SearchStream(
customerId,
query,
delegate (SearchGoogleAdsStreamResponse response)
{
foreach (GoogleAdsRow row in response.Results)
{
Console.WriteLine(
$"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
}
});
}
catch (GoogleAdsException ex)
{
Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}
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
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 entorno de ejecución, archivos JSON personalizados o appsettings.json,
variables de entorno o archivos App.config. En caso de que
necesites modificar el comportamiento de registro de la biblioteca cliente, consulta la
guía del interceptor de gRPC personalizado.
Utilidades
La biblioteca cliente de .NET incluye clases de utilidad para mejorar la usabilidad de la API,
incluidos los asistentes de carga de contenido multimedia y videos (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.