.NET

Google stellt eine .NET-Clientbibliothek für die Interaktion mit der Ad Manager API bereit. Wir empfehlen, die Clientbibliothek mit NuGet zu verwenden.

Erstellen Sie zuerst ein neues Projekt in der IDE Ihrer Wahl oder fügen Sie die Abhängigkeit einem vorhandenen Projekt hinzu. Google veröffentlicht Clientbibliotheksartefakte im NuGet-Repository als Google.Ads.AdManager.V1.

<!-- MyProject.csproj -->
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

Anmeldedaten konfigurieren

Die .NET-Clientbibliothek verwendet OAuth2 und Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) zur Authentifizierung.

ADC sucht in der folgenden Reihenfolge an den folgenden Standorten nach Anmeldedaten:

1. GOOGLE_APPLICATION_CREDENTIALS-Umgebungsvariable.
2. Über die Google Cloud CLI (gcloud CLI) eingerichtete Nutzeranmeldedaten
3. Wenn die Ausführung in Google Cloud erfolgt, das an die Google Cloud-Ressource angehängte Dienstkonto.

Informationen zum Erstellen und Konfigurieren Ihrer ADC-Anmeldedaten finden Sie unter Authentifizierung.

Erste Anfrage senden

Jeder Dienst hat ein ServiceClient-Objekt mit synchronen und asynchronen Methoden für jede REST-Methode. Im folgenden Beispiel wird ein Network synchron gelesen. Alle Entitäten werden durch einen Ressourcennamen identifiziert, der aus dem Typ und der numerischen Kennung der Entität besteht.

    using Google.Ads.AdManager.V1;

    public sealed partial class GeneratedNetworkServiceClientSnippets
    {
        public void GetNetwork()
        {
            // Create client
            NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
            // Initialize request argument(s)
            string name = "networks/[NETWORK_CODE]";
            // Make the request
            Network response = networkServiceClient.GetNetwork(name);
        }
    }
NetworkServiceClient.GetNetworkSnippet.g.cs

Beispiele für andere Methoden und Ressourcen finden Sie im GitHub-Repository googleapis/google-cloud-dotnet.

Fehler verarbeiten

Alle Ad Manager API-Fehler sind in der.NET-Clientbibliothek vom Typ Grpc.Core.RpcException.

Fehler enthalten eine eindeutige request_id, die du dem Support zur Fehlerbehebung mitteilen kannst. Im folgenden Beispiel werden der HTTP-Status, die Fehlermeldung und request_id extrahiert.

using Google.Ads.AdManager.V1;
using Google.Api.Gax.Grpc;
using Google.Rpc;
using Grpc.Core;

try
{
    NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
    Network network = networkServiceClient.GetNetwork("networks/[NETWORK_CODE]");
}
catch(RpcException e)
{
    // HTTP Status code
    StatusCode statusCode = e.Status.StatusCode;
    // Error message
    string errorMessage = e.Status.Detail;
    // Unique request identifier.
    RequestInfo requestInfo = e.GetStatusDetail<RequestInfo>();
    string requestId = requestInfo?.RequestId ?? "Unexpected null request identifier";
}

Ressourcennamen erstellen

Die Clientbibliothek bietet Hilfsklassen zum Erstellen von Ressourcennamen aus IDs. Diese können direkt an Dienstmethoden übergeben werden.

//  Represents a resource name in the format:
//  "networks/{networkCode}/orders/{orderId}"
OrderName name = OrderName.FromNetworkCodeOrder("123", "456");
Order response = orderServiceClient.GetOrder(name);

Proxy-Einstellungen konfigurieren

Die .NET-Clientbibliothek berücksichtigt die Eigenschaft HttpClient.DefaultProxy, einschließlich der Festlegung von Proxys über die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY. Weitere Informationen finden Sie unter HttpClient.DefaultProxy-Eigenschaft.