googleads dotnet lib

Bibliothèque client .NET de l'API SOAP de Google Ad Manager

Ce projet héberge la bibliothèque client .NET pour l'API SOAP de Google Ad Manager.

Caractéristiques

• Distribué via Nuget
• Classes de stub pour toutes les versions et services d'API pris en charge.
• Utilitaires utiles
• Les messages SOAP sont enregistrés, à des fins de débogage plus faciles
• Gestion automatique des en-têtes SOAP
• Gestion facile des informations d'identification, d'authentification et de session
• Documents disponibles au format HTML et XML.

Cadres pris en charge

• .NET Framework 4.5.2+
• .NET Standard 2.0 (prise en charge limitée)

Annonces et mises à jour

Pour connaître les mises à jour et les actualités de l'API et de la bibliothèque client, veuillez suivre notre blog des développeurs Google Ads : http://googleadsdeveloper.blogspot.com/.

Commencer

1. Installez votre bibliothèque. Nous vous recommandons d'utiliser la distribution Nuget suivante :

• Google.Dfp : bibliothèque client DotNet de l'API Ad Manager

Vous pouvez en savoir plus sur le gestionnaire de packages nuget sur http://www.nuget.org. Pour d'autres options de distribution, consultez les options de distribution alternatives ci-dessous.

1. Configurez vos informations d'identification OAuth2.

L'API et Ad Manager utilise OAuth2 comme mécanisme d'authentification. Suivez le guide approprié ci-dessous en fonction de votre cas d'utilisation.

Si vous accédez à une API en utilisant vos propres informations d'identification...

• Utiliser des comptes de service

Si vous accédez à une API au nom de clients...

• Développer une application web

Options de distribution alternatives

Distribution binaire

La distribution binaire de la bibliothèque .NET de l'API Ads se compose d'une version précompilée de la bibliothèque sous forme d'assembly .NET, d'exemples de code pour l'utilisation de la bibliothèque et de la documentation de la bibliothèque. Si vous souhaitez uniquement utiliser la bibliothèque et non ses composants internes, et que vous n'utilisez pas le gestionnaire de packages nuget dans votre environnement de développement, vous devez télécharger cette distribution.

Le contenu de cette distribution est le suivant :

  
    lib
      - Precompiled assemblies.
      - Documentation xmls for the assemblies.
    examples
       Code examples, in C# and VB.NET (when available).
    README
    ChangeLog
    COPYING
    Visual Studio solution file

Pour exécuter les exemples de code :

• Ouvrez le fichier de solution Visual Studio dans le dossier racine de la distribution binaire dans Microsoft Visual Studio
• Ouvrez App.config pour le projet d'exemples et suivez les instructions du fichier pour saisir les valeurs de configuration requises.
• Enregistrez et fermez App.config .
• Ouvrez la boîte de dialogue Propriétés du projet Exemples (cliquez avec le bouton droit sur le projet Exemples de votre choix dans l'Explorateur de solutions et sélectionnez l'option Propriétés dans le menu contextuel.).
• Accédez à l'onglet Débogage et entrez les options de ligne de commande. Les options de ligne de commande sont au format version.examplename . Par exemple, v202308.GetCurrentNetwork est l'option de ligne de commande permettant d'exécuter l'exemple GetCurrentNetwork dans la version v202308 de l'API Ad Manager.
• Compilez et exécutez le projet Exemples.

Alternativement, chaque exemple de code possède une méthode main() , vous pouvez donc définir l'exemple de code approprié comme objet de démarrage (sélectionnez l'onglet Application dans la boîte de dialogue Propriétés des exemples et choisissez la classe souhaitée dans la liste déroulante "Objet de démarrage".).

Pour utiliser la bibliothèque dans un nouveau projet :

• Créez un nouveau projet Visual Studio de votre choix (par exemple, une application Windows C#).
• Copiez le dossier lib de la distribution binaire dans votre dossier de projet. Ajoutez des références à tous les assemblys de ce dossier dans votre projet.
• Ajoutez une référence à System.Web.Services dans votre projet.
• Copiez examplesApp.config dans le répertoire de votre projet et ajoutez-le à votre projet.
• Modifiez les clés requises dans App.config . Si votre application possède son propre App.config , vous devez alors fusionner son contenu avec le contenu de examplesApp.config .
• Appelez la bibliothèque, par exemple :

 // Create an appropriate AdsUser instance.
AdManagerUser user = new AdManagerUser();

// Create the required service.
using (NetworkService networkService = user.GetService())
{
    // make calls to service class.
}

Vous pouvez vous référer à cet article wiki pour plus de détails.

Comment activer la journalisation

Voir https://github.com/googleads/googleads-dotnet-lib/wiki#logging pour plus de détails.

Divers

Wiki

• https://github.com/googleads/googleads-dotnet-lib/wiki

Suivi des problèmes

• https://github.com/googleads/googleads-dotnet-lib/issues

Documentation API :

• https://developers.google.com/ad-manager/api

Forum d'assistance

• https://developers.google.com/doubleclick-publishers/community

Auteurs

• https://github.com/AnashOommen
• https://github.com/ChristopherSeeley
• https://github.com/jimper