googleads dotnet lib

Biblioteca cliente .NET de la API SOAP de Google Ad Manager

Este proyecto aloja la biblioteca cliente .NET para la API SOAP de Google Ad Manager.

Características

• Distribuido a través de Nuget
• Clases auxiliares para todas las versiones y servicios de API compatibles.
• Utilidades útiles
• Los mensajes SOAP se registran para facilitar la depuración
• Manejo automático de encabezados SOAP
• Fácil gestión de credenciales, autenticación e información de sesión.
• Documentos disponibles en formato HTML y XML.

Marcos soportados

• Marco .NET 4.5.2+
• .NET Standard 2.0 (soporte limitado)

Anuncios y actualizaciones

Para obtener actualizaciones y noticias sobre API y biblioteca cliente, siga nuestro blog para desarrolladores de Google Ads: http://googleadsdeveloper.blogspot.com/.

Empezando

1. Instale su biblioteca. Recomendamos utilizar la siguiente distribución Nuget:

• Google.Dfp: Biblioteca cliente DotNet de la API de Ad Manager

Puede obtener más información sobre el administrador de paquetes Nuget en http://www.nuget.org. Para otras opciones de distribución, consulte las opciones de distribución alternativas a continuación.

1. Configure sus credenciales de OAuth2.

La API de Ad Manager utiliza OAuth2 como mecanismo de autenticación. Siga la guía adecuada a continuación según su caso de uso.

Si accede a una API utilizando sus propias credenciales...

• Usar cuentas de servicio

Si accede a una API en nombre de clientes...

• Desarrollando una aplicación web

Opciones de distribución alternativas

Distribución binaria

La distribución binaria de la biblioteca .NET de Ads API consta de una versión precompilada de la biblioteca como un ensamblado .NET, ejemplos de código para usar la biblioteca y documentación de la biblioteca. Si está interesado solo en usar la biblioteca y no en sus partes internas, y no usa el administrador de paquetes Nuget en su entorno de desarrollo, entonces debe descargar esta distribución.

El contenido de esta distribución es el siguiente:

  
    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

Para ejecutar los ejemplos de código:

• Abra el archivo de solución de Visual Studio en la carpeta raíz de la distribución binaria en Microsoft Visual Studio
• Abra App.config para ver el proyecto de ejemplos y siga las instrucciones del archivo para ingresar los valores de configuración requeridos.
• Guarde y cierre App.config .
• Abra el cuadro de diálogo Propiedades para el proyecto de Ejemplos (haga clic con el botón derecho en el proyecto de Ejemplos de su elección en el Explorador de soluciones y seleccione la opción Propiedades en el menú contextual).
• Navegue a la pestaña Depurar e ingrese las opciones de la línea de comando. Las opciones de la línea de comando tienen el formato version.examplename . Por ejemplo, v202308.GetCurrentNetwork es la opción de línea de comando para ejecutar el ejemplo GetCurrentNetwork en la versión v202308 de la API de Ad Manager.
• Compile y ejecute el proyecto de ejemplos.

Alternativamente, cada ejemplo de código tiene un método main() , por lo que puede configurar el ejemplo de código apropiado como objeto de inicio (seleccione la pestaña Aplicación en el cuadro de diálogo Propiedades de ejemplos y elija la clase deseada en el menú desplegable "Objeto de inicio").

Para utilizar la biblioteca en un nuevo proyecto:

• Cree un nuevo proyecto de Visual Studio de su elección (por ejemplo, una aplicación C# para Windows).
• Copie la carpeta lib de la distribución binaria a la carpeta de su proyecto. Agregue referencias a todos los ensamblajes en esta carpeta en su proyecto.
• Agregue una referencia a System.Web.Services en su proyecto.
• Copie examplesApp.config al directorio de su proyecto y agréguelo a su proyecto.
• Edite las claves requeridas en App.config . Si su aplicación tiene su propio App.config , entonces necesita fusionar su contenido con el contenido de examplesApp.config .
• Haga una llamada a la biblioteca, por ejemplo:

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

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

Puede consultar este artículo de wiki para obtener más detalles.

Cómo habilitar el registro

Consulte https://github.com/googleads/googleads-dotnet-lib/wiki#logging para obtener más detalles.

Misceláneas

wiki

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

Rastreador de problemas

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

Documentación API:

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

Foro de soporte

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

Autores

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