Saltar al contenido

Detalles de Conexión del Google Ad Manager

Introducción

Versión del conector

Esta documentación se basa en la versión 21.0.8361 del conector.

Empezando

Compatibilidad con la versión de Google Ad Manager

Establecer una Conexión

Conexión con el Google Ad Manager

Proporcione las siguientes propiedades de conexión antes de agregar las propiedades de autenticación.

  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Autenticación en Google Ad Manager

Todas las conexiones con Google Ad Manager se autentican mediante OAuth. El conector admite el uso de cuentas de usuario, cuentas de servicio y cuentas de instancias de GCP para la autenticación.

Autenticarse con una Cuenta de Usuario

AuthScheme debe establecerse en OAuth en todos los flujos de cuentas de usuario. Para las aplicaciones de escritorio, la aplicación predeterminada del conector es la forma más sencilla de autenticación. El único requisito adicional es establecer InitiateOAuth a GETANDREFRESH.

Cuando se inicie el controlador, se abrirá un navegador y Google Ad Manager solicitará su información de inicio de sesión. El conector utilizará las credenciales que proporcione para acceder a sus datos de Google Ad Manager. Estas credenciales se guardarán y actualizarán automáticamente según sea necesario.

Consulte Uso de la autenticación OAuth para obtener una guía de autenticación que cubra todos los métodos admitidos en detalle.

Autenticarse con una Cuenta de Servicio

Para autenticarse usando una cuenta de servicio, debe crear una nueva cuenta de servicio y tener una copia del certificado de la cuenta.

Para un archivo JSON, deberá establecer estas propiedades:

  • AuthScheme: Requerido. Establézcalo en OAuthJWT.
  • InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
  • OAuthJWTCertType: Requerido. Establézcalo en GOOGLEJSON.
  • OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .json proporcionado por Google.
  • OAuthJWTSubject: Opcional. Establezca este valor solo si la cuenta de servicio es parte de un dominio de GSuite y desea habilitar la delegación. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Para un archivo PFX, deberá establecer estas propiedades en su lugar:

  • AuthScheme: Requerido. Establézcalo en OAuthJWT.
  • InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
  • OAuthJWTCertType: Requerido. Establézcalo en PFXFILE.
  • OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .pfx proporcionado por Google.
  • OAuthJWTCertPassword: Opcional. Establézcalo en la contraseña del archivo .pfx. En la mayoría de los casos, será necesario proporcionarlo, ya que Google cifra los certificados PFX.
  • OAuthJWTCertSubject: Opcional. Configure esto solo si está usando un OAuthJWTCertType que almacena múltiples certificados. No debe configurarse para certificados PFX generados por Google.
  • OAuthJWTIssuer: Requerido. Establézcalo en la dirección de correo de la cuenta de servicio. Esta dirección generalmente incluirá el dominio iam.gserviceaccount.com.
  • OAuthJWTSubject: Opcional. Establezca este valor solo si la cuenta de servicio es parte de un dominio de GSuite y desea habilitar la delegación. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Si aún no tiene una cuenta de servicio, puede crear una siguiendo el procedimiento en Crear una aplicación OAuth personalizada.

Autenticarse con una Cuenta de Instancia de GCP

Cuando se ejecuta en una máquina virtual de GCP, el conector puede autenticarse mediante una cuenta de servicio vinculada a la máquina virtual. Para usar este modo, configure AuthScheme a GCPInstanceAccount.

Uso de la Autenticación OAuth

Utilice el estándar de autenticación OAuth para conectarse a Google Ad Manager. Puede autenticarse con una cuenta de usuario o una cuenta de servicio. El conector facilita esto como se describe a continuación.

Uso de una Cuenta de Usuario para Autenticarse en Google Ad Manager

El flujo de la cuenta de usuario requiere que el usuario que se autentica interactúe con Google Ad Manager a través del navegador.

Credenciales Integradas

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada.

Credenciales Personalizadas

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación para obtener OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Google Ad Manager y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Google Ad Manager para otorgar permisos al conector.

Uso de una Cuenta de Servicio para Conectarse a Google Ad Manager

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Luego puede conectarse a los datos de Google Ad Manager a los que la cuenta de servicio tiene permiso para acceder. Consulte Credenciales personalizadas para obtener una guía de autenticación.

Creación de una Aplicación OAuth Personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas

Autenticarse con las Credenciales de OAuth Integradas
Autenticación de Escritorio con la Aplicación OAuth Integrada

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

  • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

  1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
  2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
  3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas

Cuándo Crear una Aplicación OAuth Personalizada
Autenticación de Cuenta de Usuario

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Google Ad Manager y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Google Ad Manager para otorgar permisos al conector.

Autenticación de Cuenta de Servicio

Debe crear una aplicación OAuth en el flujo de la cuenta de servicio.

Autenticarse con una Cuenta de Usuario
Autenticación de Escritorio con una Aplicación OAuth Personalizada

Después de Crear una aplicación OAuth personalizada, siga los pasos a continuación para autenticarse con las credenciales de su aplicación personalizada.

Obtenga y actualice el token de acceso de OAuth

Después de configurar lo siguiente, está listo para conectarse:

  • OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
  • OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
  • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

  1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
  2. Actualiza el token de acceso cuando caduca.
  3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
Autenticarse con una Cuenta de Servicio

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para otorgar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación.

Luego puede conectarse a los datos de Google Ad Manager a los que la cuenta de servicio tiene permiso para acceder. Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

  • InitiateOAuth: Establézcalo en GETANDREFRESH.
  • OAuthJWTCertType: Ajústelo a "PFXFILE".
  • OAuthJWTCertPassword: establezca esto en la contraseña del archivo .p12.
  • OAuthJWTCertSubject: establezca esto en "*" para elegir el primer certificado en el almacén de certificados.
  • OAuthJWTIssuer: establezca esto en la dirección de correo de la cuenta de servicio.
  • OAuthJWTCert: Establézcalo en la ruta del archivo .p12.
  • OAuthJWTSubject: establezca esto en la dirección de correo del usuario para quien la aplicación solicita acceso de delegado. Tenga en cuenta que el acceso de delegado debe ser otorgado por un administrador.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

  1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
  2. Intercambia el JWT por el token de acceso.
  3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
  4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Las siguientes secciones muestran cómo autenticar un servidor sin periféricos u otra máquina en la que el conector no puede abrir un navegador. Puede autenticarse con una cuenta de usuario o con una cuenta de servicio.

Autenticarse con una Cuenta de Usuario

Para autenticarse con una cuenta de usuario, debe hacerlo desde otra máquina. La autenticación es un proceso de dos pasos.

  1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
  2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales de OAuth Integradas

Obtenga un código verificador

Siga los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión:

  1. Haga clic en el siguiente enlace para abrir el extremo de OAuth de Google Ad Manager en su navegador.
  2. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
  3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth.

  • OAuthVerifier: Establézcalo en el código del verificador.
  • InitiateOAuth: Establézcalo en ACTUALIZAR.
  • OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

  • OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
  • InitiateOAuth: Establézcalo en ACTUALIZAR.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

  • OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
  • InitiateOAuth: Establézcalo en GETANDREFRESH.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Pruebe la conexión para autenticarse en el navegador. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

  • InitiateOAuth: Establézcalo en ACTUALIZAR.
  • OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.
Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

La creación de una aplicación de OAuth personalizada es opcional en el flujo de OAuth sin interfaz; puede omitir la creación de una aplicación conectándose con las credenciales de OAuth integradas del conector. Es posible que desee crear una aplicación OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Google Ad Manager para otorgar permisos al conector.

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

  • InitiateOAuth: Ajústelo a APAGADO.
  • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
  • OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

  1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
  2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
  3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

  • OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
  • OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
  • OAuthVerifier: Establézcalo en el código del verificador.
  • OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
  • InitiateOAuth: Establézcalo en ACTUALIZAR.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

  • OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
  • OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
  • OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
  • InitiateOAuth: Establézcalo en ACTUALIZAR.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

  • OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
  • InitiateOAuth: Establézcalo en GETANDREFRESH.
  • OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
  • OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

  • InitiateOAuth: Establézcalo en ACTUALIZAR.
  • OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
  • OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
  • OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.
Autenticarse con una Cuenta de Servicio

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación. Luego puede conectarse a los datos de Google Ad Manager a los que la cuenta de servicio tiene permiso para acceder.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

  • InitiateOAuth: Establézcalo en GETANDREFRESH.
  • OAuthJWTCertType: Ajústelo a "PFXFILE".
  • OAuthJWTCertPassword: establezca esto en la contraseña del archivo .p12.
  • OAuthJWTCertSubject: establezca esto en "*" para elegir el primer certificado en el almacén de certificados.
  • OAuthJWTIssuer: establezca esto en la dirección de correo de la cuenta de servicio.
  • OAuthJWTCert: Establézcalo en la ruta del archivo .p12.
  • OAuthJWTSubject: establezca esto en la dirección de correo del usuario para quien la aplicación solicita acceso de delegado. Tenga en cuenta que el acceso de delegado debe ser otorgado por un administrador.
  • NetworkCode: Selecciona el NetworkCode propiedad de conexión al código de red que se muestra en la URL cuando inicia sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

  1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
  2. Intercambia el JWT por el token de acceso.
  3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
  4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Creación de una Aplicación OAuth Personalizada

Cuándo Crear una Aplicación OAuth Personalizada
Autenticación de Cuenta de Usuario

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Google Ad Manager y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Google Ad Manager para otorgar permisos al conector.

Autenticación de Cuenta de Servicio

Debe crear una aplicación OAuth en el flujo de la cuenta de servicio.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Usuario

Siga el procedimiento a continuación para registrar una aplicación y obtener el OAuthClientId y OAuthClientSecret.

Crear una Aplicación OAuth Personalizada: Escritorio
  1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
  2. Haga clic en Credenciales -> Crear credenciales -> ID de cliente de OAuth. Haz clic en Otro.

Después de crear la aplicación, OAuthClientId y OAuthClientSecret son mostrados.

Configure su red de DFP

Siga los pasos a continuación para autorizar la aplicación; si es un desarrollador externo, es posible que necesite que su cliente realice estos pasos por usted.

  1. Vaya a su red de DoubleClickFP for Publishers.
  2. Haga clic en la pestaña Administrador.
  3. Asegúrese de que el acceso a la API esté habilitado.
Cree una Aplicación OAuth para la Autenticación de Cuentas de Servicio

Para obtener las propiedades de autenticación necesarias, siga los pasos a continuación para crear una aplicación OAuth y generar una clave privada:

  1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
  2. Haga clic en Crear credenciales -> Clave de cuenta de servicio.
  3. En el menú Cuenta de servicio, seleccione Nueva cuenta de servicio o seleccione una cuenta de servicio existente.
  4. Si está creando una nueva cuenta de servicio, seleccione además uno o más roles. Puede asignar roles primitivos a nivel de proyecto en la sección IAM y Admin; otras funciones le permiten personalizar aún más el acceso a las APIs de Google.
  5. En la sección Tipo de clave, seleccione el tipo de clave P12.
  6. Cree la aplicación para descargar el par de claves. Se muestra la contraseña de la clave privada: Configure esto en OAuthJWTCertPassword.
  7. En la sección de cuentas de servicio, haga clic en Administrar cuentas de servicio y configure OAuthJWTIssuer a la dirección de correo que se muestra en el campo ID de la cuenta de servicio.

Configure su red de DFP

Si es un desarrollador externo, es posible que necesite que su cliente haga este paso por usted.

  1. Vaya a su red de DoubleClickFP for Publishers.
  2. Haga clic en la pestaña Administrador.
  3. Asegúrese de que el acceso a la API esté habilitado.

Siga los pasos a continuación para autorizar la aplicación; entonces estará listo para seguir la guía de autenticación.

  1. Haga clic en el botón Agregar un usuario de cuenta de servicio.
  2. Complete el formulario utilizando el correo de la cuenta de servicio.
  3. Haga clic en el botón Guardar. Aparece un mensaje que confirma la adición de su cuenta de servicio.
  4. Para ver los usuarios de la cuenta de servicio existente, vaya a la pestaña Usuarios y luego haga clic en el filtro Cuenta de servicio.

Notas Importantes

Procedimientos Almacenados

  • Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
  • Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas

  • Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas

Esta sección detalla una selección de funciones avanzadas del conector de Google Ad Manager.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario

El conector Jitterbit para Google Ads Manager le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

  • Cree un archivo de configuración con formato JSON que defina las vistas que desea.
  • Declaraciones DDL.

Definición de Vistas Utilizando un Archivo de Configuración

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

  • Cada elemento raíz define el nombre de una vista.
  • Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM Orders WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL

Personalización de la Configuración SSL

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos

Jitterbit Connector para Google Ads Manager modela los objetos de Google Ad Manager como tablas y vistas relacionales. Un objeto de Google Ad Manager tiene relaciones con otros objetos; en las tablas, estas relaciones se expresan a través de claves foráneas. Las siguientes secciones muestran los objetos API disponibles y brindan más información sobre cómo ejecutar SQL en las APIs de Google Ad Manager.

Los esquemas para la mayoría de los objetos de la base de datos se definen en archivos de configuración simples basados en texto. Sin embargo, los esquemas para los informes de consultas guardadas se obtienen dinámicamente.

Acceso a informes de consultas guardadas

Cuando se conecta, el conector recupera la lista de informes y los metadatos de las tablas llamando a los servicios web correspondientes. Cualquier cambio que realice en los informes de consultas guardadas, como agregar un nuevo informe, agregar nuevos campos o cambiar el tipo de datos de un campo, se reflejará inmediatamente cuando se conecte mediante el conector.

El conector descarga la mayor parte posible del procesamiento de la declaración SELECT a las APIs de Google Ad Manager y luego procesa el resto de la consultar en la memoria. Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Insertar campos personalizados

Al ejecutar una declaración de inserción y ha especificado un campo personalizado, el valor del campo personalizado debe ser un agregado. El agregado debe contener el ID del campo personalizado y el valor que desea darle. Puede obtener ID de campos personalizados consultando la tabla CustomFields. Actualmente, solo se admiten campos personalizados de tipo "Texto" para Insertar. Otros tipos no son insertables/actualizables.

A continuación se muestra un ejemplo de inserción en la tabla Pedidos al especificar el campo personalizado "MyOwnCustomField". El ID del campo personalizado es 1238676 y su valor es "Texto de muestra aquí".

INSERT INTO Orders (Name, Notes, AdvertiserId, TraffickerId, CreatorId, Status, MyOwnCustomField) VALUES ('T-Shirt', 'Note description', '7412504329', '452586926', '9521226', 'DRAFT', '<customFieldId> 1238676 </customFieldId><value xsi:type="TextValue"><value> Sample text here </value></value>')

Mesas

El conector modela los datos en Google Ad Manager en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Por lo general, consultar las tablas de Google Ad Manager es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas de Google Ads Manager

Nombre Descripción
Companies Cree, actualice y consultar DoubleClick for Publishers Companies.
Contacts Crear, actualizar y consultar contactos de DoubleClick for Publishers.
Creatives Actualice y consultar las creatividades de DoubleClick for Publishers.
CustomFields Crear, actualizar y consultar campos personalizados de DoubleClick for Publishers.
CustomTargetingKeys Cree, actualice y consultar claves de orientación personalizadas de DoubleClick for Publishers.
Inventories Cree, actualice y consultar inventarios de DoubleClick for Publishers.
Labels Cree, actualice, elimine y consultar etiquetas de DoubleClick for Publishers.
LineItemCreativeAssociations Consulta DoubleClick para Publishers LineItemCreativeAssociations.
LineItems Cree, actualice, elimine y consultar elementos de línea de DoubleClick for Publishers.
MobileApplications Crear y consultar aplicaciones móviles de DoubleClick for Publishers.
Orders Cree, actualice, elimine y consultar pedidos de DoubleClick for Publishers.
Placements Cree, actualice, elimine y consultar ubicaciones de DoubleClick for Publishers.
ProposalLineItems Cree, actualice y consultar DoubleClick for Publishers ProposalLineItems.
Proposals Crear, actualizar y consultar propuestas de DoubleClick for Publishers.
Users Crear, actualizar, eliminar y consultar usuarios de DoubleClick for Publishers.

Compañías

Cree, actualice y consultar DoubleClick for Publishers Companies.

Seleccionar

Las siguientes consultas se procesan del lado del servidor. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de empresas. Por ejemplo:

SELECT * FROM [Companies]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Compañías] WHERE ID = '4410125029'
Insertar

Para crear una nueva Empresa, los campos Nombre y Tipo son obligatorios.

INSERT INTO [Compañías] (Name, Type) VALUES ('CompName', 'ADVERTISER')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Compañías] SET Name = 'New CompName' WHERE ID = '4410125029'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero Identifica de forma única a la Compañía. Este valor es de solo lectura y lo asigna Google cuando se crea la empresa. Este atributo es necesario para las actualizaciones.
Name String Falso El nombre completo de la empresa. Este atributo es obligatorio y tiene una longitud máxima de 127 caracteres.
Type String Falso Especifica qué tipo de empresa es esta. Este atributo es obligatorio. Los valores permitidos son ANUNCIANTE, HOUSE_ANUNCIANTE, HOUSE_AGENCY, AGENCY, AD_NETWORK, AFFILIATE_DISTRIBUTION_PARTNER, CONTENT_PARTNER, UNKNOWN.
CreditStatus String Verdadero Especifica el estado crediticio de la empresa. Este atributo es opcional y el valor predeterminado es CreditStatus.ACTIVE cuando la configuración básica del estado del crédito está habilitada y CreditStatus.ON_HOLD cuando la configuración avanzada del estado del crédito está habilitada.
LastModifiedDateTime Datetime Verdadero La fecha y hora de la última modificación de esta empresa.

Contactos

Crear, actualizar y consultar contactos de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan del lado del servidor. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de contactos. Por ejemplo:

SELECT * FROM [Contacts]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Contactos] WHERE ID = '4940864'
Insertar

Para crear un nuevo contacto, se requieren los campos Nombre, CompanyId y Correo.

INSERT INTO [Contactos] (Name, CompanyId, Email) VALUES ('Cont', '4415064655', 'cont@email.com')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Contactos] SET Name = 'New Contact', Email = 'email@yahoo.com' WHERE ID = '4944377'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero La identificación única del contacto. Este valor es de solo lectura y lo asigna Google.
Name String Falso El nombre del contacto. Este atributo es obligatorio y tiene una longitud máxima de 127 caracteres.
CompanyId Long Falso El ID de la empresa con la que está asociado este contacto. Este atributo es obligatorio e inmutable.
Status String Falso El estado del contacto. Este atributo es de solo lectura y lo asigna Google.
Email String Falso La dirección de correo electrónico donde se puede contactar al contacto. Este atributo es opcional.
Address String Falso La dirección del contacto. Este atributo es opcional y tiene una longitud máxima de 1024 caracteres.
CellPhone String Falso El número de teléfono celular donde se puede localizar al contacto. Este atributo es opcional.
Comment String Falso Un comentario de texto de formato libre para el contacto. Este atributo es opcional y tiene una longitud máxima de 1024 caracteres.
FaxPhone String Falso El número de fax donde se puede localizar al contacto. Este atributo es opcional.
Title String Falso El puesto de trabajo del contacto. Este atributo es opcional y tiene una longitud máxima de 1024 caracteres.
WorkPhone String Falso El número de teléfono del trabajo donde se puede localizar al contacto. Este atributo es opcional.

Creatividades

Actualice y consultar las creatividades de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de Creatividades. Por ejemplo:

SELECT * FROM [Creatives]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Creatividades] WHERE ID = '138206791680'
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Creatividades] SET Name = 'Updated creative' WHERE ID = '138206791680'
Insertar

La operación de inserción no es compatible con esta tabla.

Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero Identifica de forma única la creatividad. Este valor es de solo lectura y lo asigna Google cuando se crea la creatividad. Este atributo es necesario para las actualizaciones.
Name String Falso El nombre de la creatividad. Este atributo es obligatorio y tiene una longitud máxima de 255 caracteres.
CompanyId Long Falso El ID del anunciante propietario de la creatividad. Este atributo es obligatorio.
Width Integer Falso El ancho de la creatividad.
Height Integer Falso El colmo de lo Creativo.
PreviewUrl String Verdadero La URL de la creatividad para obtener una vista previa de los medios. Este atributo es de solo lectura y lo asigna Google cuando se crea una creatividad.
DestinationUrl String Falso La URL a la que se dirige al usuario si hace clic en la creatividad. Este atributo solo es necesario si el fragmento de la modelo contiene la macro %u o %%DEST_URL%%. Tiene una longitud máxima de 1024 caracteres
LastModifiedDateTime Datetime Verdadero La fecha y la hora en que se modificó por última vez esta creatividad.
Snippet String Verdadero El fragmento HTML que publica esta creatividad. Este atributo es obligatorio.
ExpandedSnippet String Verdadero El fragmento de código HTML que publica esta creatividad con las macros expandidas. Este atributo es de solo lectura y lo establece Google.
SslScanResult String Verdadero El resultado del análisis de compatibilidad SSL para esta creatividad.
LockedOrientation String Verdadero Una orientación bloqueada para que se muestre esta creatividad.
OverrideSize Boolean Verdadero Permite que el tamaño de la creatividad difiera del tamaño real del elemento HTML5. Este atributo es opcional. URL de seguimiento de impresiones de terceros.
IsSafeFrameCompatible Boolean Verdadero Si la creatividad es compatible con el procesamiento de SafeFrame.
PrimaryImageId Long Verdadero Identifica de forma única la creatividad. Este valor es de solo lectura y lo asigna Google cuando se crea la creatividad. Este atributo es necesario para las actualizaciones.
PrimaryImageName String Verdadero El nombre de la creatividad. Este atributo es obligatorio y tiene una longitud máxima de 255 caracteres.
PrimaryImageSize Long Verdadero Tamaño de la imagen principal
PrimaryImageUrl String Verdadero URL de la imagen principal
CustomFieldName String Verdadero Este es el nombre del campo personalizado. Habrá tantas columnas personalizadas como campos personalizados estén relacionados con las creatividades.

Campos Personalizados

Crear, actualizar y consultar campos personalizados de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de CustomFields. Por ejemplo:

SELECT * FROM [CustomFields]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Campos Personalizados] WHERE ID = '1238676'
Insertar

Para crear un CustomField nuevo, se requieren los campos Nombre, Tipo de entidad, Tipo de datos y Visibilidad.

INSERT INTO [Campos Personalizados] (Name, EntityType, DataType, Visibility) VALUES ('ASEF', 'LINE_ITEM', 'STRING', 'FULL')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Campos Personalizados] SET Description = 'New Description' WHERE ID = '1238676'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero ID único de CustomField. Este valor es de solo lectura y lo asigna Google.
Name String Falso Nombre del campo personalizado. Este valor es necesario para crear un campo personalizado. La longitud máxima es de 127 caracteres.
Description String Falso Una descripción del campo personalizado. Este valor es opcional. La longitud máxima es de 511 caracteres
IsActive Boolean Verdadero Especifica si los campos personalizados están activos o no. Este atributo es de solo lectura.
EntityType String Falso El tipo de entidad con la que está asociado este campo personalizado. Este atributo es de solo lectura si existe un CustomFieldValue para este campo. Los valores permitidos son LINE_ITEM, ORDER, CREATIVE, PRODUCT_TEMPLATE, PRODUCT, PROPOSAL, PROPOSAL_LINE_ITEM, USER, UNKNOWN.
DataType String Falso El tipo de datos que contiene este campo personalizado. Este atributo es de solo lectura si existe un CustomFieldValue para este campo. Los valores permitidos son STRING, NUMBER, TOGGLE, DROP_DOWN, UNKNOWN.
Visibility String Falso Cuán visible/accesible es este campo en la interfaz de usuario. Los valores permitidos son API_ONLY, READ_ONLY, FULL.

Claves de Orientación Personalizadas

Cree, actualice y consultar claves de orientación personalizadas de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de CustomFields. Por ejemplo:

SELECT * FROM [CustomTargetingKeys]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Claves de orientación personalizadas] WHERE ID = '10721398'
Insertar

Para crear una nueva CustomTargetingKey, los campos Name, DisplayName y Type son obligatorios.

INSERT INTO [Claves de orientación personalizadas] (Name, DisplayName, Type) VALUES ('tg_key', 'targeting key', 'PREDEFINED')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura (excepto la columna Nombre que solo se puede insertar), especificando la columna ID.

UPDATE [Claves de orientación personalizadas] SET DisplayName = 'targeting key (Deprecated)' WHERE ID = '10721398'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero El ID de CustomTargetingKey. Este valor es de solo lectura y lo completa Google.
Name String Falso Nombre de la clave. Esto se puede utilizar para la codificación. Si no desea que los usuarios puedan ver información de orientación potencialmente confidencial en las etiquetas de anuncios de su sitio, puede codificar sus claves/valores. Por ejemplo, puede crear clave/valor g1=abc para representar género=mujer. Las claves pueden contener hasta 10 caracteres cada una.
DisplayName String Falso Nombre descriptivo de la clave.
Type String Falso Indica si los usuarios seleccionarán entre valores predefinidos o crearán nuevos valores de orientación, al tiempo que especifican los criterios de orientación para una línea de pedido. Los valores permitidos son PREDEFINIDO, FORMA LIBRE.
Status String Verdadero Estado de CustomTargetingKey. Este campo es de solo lectura. Una clave se puede activar y desactivar llamando a CustomTargetingService.performCustomTargetingKeyAction.

Inventarios

Cree, actualice y consultar inventarios de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de inventarios. Por ejemplo:

SELECT * FROM [Inventories]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Inventarios] WHERE ID = '21619885919'
Insertar

Para crear un nuevo inventario, se requieren los campos ParentId y Name. Además, también puede establecer Descripción y TargetWindow.

INSERT INTO [Inventarios] (ParentId, Name, Description, TargetWindow) VALUES ('45429123', 'Ad_Unit_122', 'Ad unit description.', 'BLANK')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Inventarios] SET Name = 'NewAdUnitName' WHERE ID = '45429003'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero Identifica de forma única el AdUnit. Este valor es de solo lectura y lo asigna Google cuando se crea un bloque de anuncios. Este atributo es necesario para las actualizaciones.
ParentId Long Falso El ID del elemento principal del bloque de anuncios. Cada bloque de anuncios tiene un padre, excepto el bloque de anuncios raíz, que es creado por Google. Este atributo es obligatorio al crear el bloque de anuncios. Una vez que se crea el bloque de anuncios, este valor será de solo lectura.
HasChildren Boolean Verdadero Este campo se establece en verdadero si el bloque de anuncios tiene elementos secundarios. Este atributo es de solo lectura y lo completa Google.
Name String Falso El nombre del bloque de anuncios. Este atributo es obligatorio y su longitud máxima es de 255 caracteres. Este atributo también debe ser único y no distingue entre mayúsculas y minúsculas.
Status String Verdadero El estado de este bloque de anuncios. El valor predeterminado es InventoryStatus.ACTIVE. Este valor no se puede actualizar directamente mediante InventoryService.updateAdUnit. Solo se puede modificar realizando acciones a través de InventoryService.performAdUnitAction.
AdUnitCode String Verdadero Cadena que se utiliza para identificar de forma exclusiva el bloque de anuncios con el fin de publicar el anuncio. Este atributo es opcional y se puede configurar durante la creación del bloque de anuncios. Si no se proporciona, Google lo asignará en función del ID de la unidad de inventario. Una vez que se crea un bloque de anuncios, su adUnitCode no se puede cambiar.
Description String Falso Una descripción del bloque de anuncios. Este valor es opcional y su longitud máxima es de 65.535 caracteres.
TargetWindow String Falso El valor que se utilizará para el atributo de destino del enlace HTML. Este valor es opcional y se interpretará como TargetWindow.TOP si se deja en blanco. Los valores permitidos son TOP, BLANK.
ExplicitlyTargeted Boolean Verdadero Si este campo se establece en verdadero, el AdUnit no se orientará implícitamente cuando su principal lo esté. Los coordinadores de publicidad deben orientar explícitamente dicho bloque de anuncios o, de lo contrario, no se publicarán líneas de pedido en él. Esta función solo está disponible para las cuentas de DFP Premium.
SmartSizeMode String Verdadero El modo de tamaño inteligente para este bloque de anuncios. Este atributo es opcional y el valor predeterminado es SmartSizeMode.NONE para tamaños fijos.
LastModifiedDateTime Datetime Verdadero La fecha y la hora en que se modificó por última vez este bloque de anuncios.
IsSetTopBoxEnabled Boolean Verdadero Marca que especifica si este bloque de anuncios representa un canal de decodificador externo. Este atributo es de solo lectura.
IsInterstitial Boolean Falso Marca que especifica si este bloque de anuncios es intersticial o no.
IsNative Boolean Falso Marca que especifica si este bloque de anuncios es nativo o no.
IsFluid Boolean Falso Marca que especifica si este bloque de anuncios es fluido o no.
ApplicationId Long Falso MobileApplication.applicationId para la aplicación CTV en la que se encuentra este bloque de anuncios. Este atributo es opcional.

Etiquetas

Cree, actualice, elimine y consultar etiquetas de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de Etiquetas. Por ejemplo:

SELECT * FROM [Labels]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Etiquetas] WHERE ID = '370450571'
Insertar

Para crear una nueva Etiqueta, los campos Nombre y Tipos son obligatorios.

INSERT INTO [Etiquetas] (Name, Types) VALUES ('new lbl', 'COMPETITIVE_EXCLUSION')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Etiquetas] SET Description = 'New Description', Name = 'New updated lbl name' WHERE ID = '370341705'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero ID único de la etiqueta. Este valor es de solo lectura y lo asigna Google.
Name String Falso Nombre de la etiqueta. Este valor es necesario para crear una etiqueta y tiene una longitud máxima de 127 caracteres.
Description String Falso Una descripción de la etiqueta. Este valor es opcional y su longitud máxima es de 255 caracteres.
IsActive Boolean Verdadero Especifica si la etiqueta está activa o no. Este atributo es de solo lectura.
Types String Falso Los tipos de la etiqueta. Los valores permitidos son COMPETITIVE_EXCLUSION, AD_UNIT_FREQUENCY_CAP, AD_EXCLUSION, CREATIVE_WRAPPER, UNKNOWN.

LineItemCreativeAssociations

Consulta DoubleClick para Publishers LineItemCreativeAssociations.

Columnas
Nombre Tipo Solo lectura Descripción
LineItemId Long Falso El ID del elemento de línea al que se debe asociar la creatividad. Este atributo es obligatorio.
CreativeId Long Falso El ID de la creatividad que se asocia con un elemento de línea. Este atributo es obligatorio si se trata de una asociación entre una línea de pedido y una creatividad. Este atributo se ignora si se trata de una asociación entre una línea de pedido y un conjunto de creatividades. Si se trata de una asociación entre una línea de pedido y una creatividad, al recuperar la asociación de la creatividad de la línea de pedido, creativeId será el ID de la creatividad. Si se trata de una asociación entre una línea de pedido y un conjunto de creatividades, al recuperar la asociación de la creatividad de la línea de pedido, creativeId será el ID de la creatividad maestra.
CreativeSetId Long Falso El ID del CreativeSet que se asocia con un LineItem. Este atributo es obligatorio si se trata de una asociación entre una línea de pedido y un conjunto de creatividades. Este campo será nulo cuando se recuperen asociaciones entre líneas de pedido y creatividades que no pertenezcan a un conjunto.
ManualCreativeRotationWeight Double Falso El peso de lo Creativo. Este valor solo se utiliza si creativeRotationType de la línea de pedido se establece en CreativeRotationType.MANUAL. Este atributo es opcional y su valor predeterminado es 10.
SequentialCreativeRotationIndex Int Falso El índice de rotación secuencial de la creatividad. Este valor se usa solo si el LineItem.creativeRotationType del elemento de línea asociado se establece en CreativeRotationType.SEQUENTIAL. Este atributo es opcional y su valor predeterminado es 1.
StartDateTime Datetime Falso Anula el valor establecido para LineItem.startDateTime. Este valor es opcional y solo es válido para las redes de Ad Manager 360.
StartDateTimeType String Falso Especifica si se debe comenzar a publicar en LineItemCreativeAssociation de inmediato, en una hora, etc. Este atributo es opcional y el valor predeterminado es StartDateTimeType.USE_START_DATE_TIME. Los valores permitidos son USE_START_DATE_TIME, IMMEDIATELY, ONE_HOUR_FROM_NOW, UNKNOWN.
EndDateTime Datetime Falso Anula LineItem.endDateTime. Este valor es opcional y solo es válido para las redes de Ad Manager 360.
DestinationUrl String Falso Anula el valor establecido para HasDestinationUrlCreative.destinationUrl. Este valor es opcional y solo es válido para las redes de Ad Manager 360.
Sizes String Falso Anula el valor establecido para Creative.size, que permite que la creatividad se publique en bloques de anuncios que, de lo contrario, no serían compatibles con su tamaño real. Este valor es opcional.
Status String Verdadero El estado de la asociación. Este atributo es de solo lectura.
Stats String Verdadero Contiene estadísticas de tráfico para la asociación. Este atributo es de solo lectura y lo completa Google. Esta será nula en caso de que aún no existan estadísticas para la asociación.
LastModifiedDateTime Datetime Falso La fecha y la hora en que se modificó por última vez esta asociación.
TargetingName String Falso Especifica CreativeTargeting para esta asociación de creatividades de línea de pedido. Este atributo es opcional. Debe coincidir con la orientación de la creatividad especificada en el CreativePlaceholder correspondiente en el elemento de línea que se está asociando con la creatividad.

Artículos de Línea

Cree, actualice, elimine y consultar elementos de línea de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de LineItems. Por ejemplo:

SELECT * FROM [LineItems]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Artículos de línea] WHERE ID = '4377540922'
Insertar

Para crear un nuevo elemento de línea, se requieren los siguientes campos: OrderId, Name, StartDateTimeType, EndDateTime, EndTimeZoneId, CreativeRotationType, LineItemType, CurrencyCode, MicroAmount, CostType, CreativePlaceholdersAgregate, AllowOverbook, GoalType, GoalUnitType, GoalUnits, GeoTargeting Aggregate e InventoryTargeting Aggregate.

INSERT INTO [Artículos de línea] (OrderId, Name, StartDateTimeType, EndDateTime, EndTimeZoneId, CreativeRotationType, LineItemType, CurrencyCode, MicroAmount, CostType, CreativePlaceholdersAggregate, AllowOverbook, GoalType, GoalUnitType, GoalUnits, GeoTargetingAggregate, InventoryTargetingAggregate) VALUES ('2108997295', 'line item 233', 'IMMEDIATELY', '2017-09-01', 'America/New_York', 'EVEN', 'STANDARD', 'USD', '200000', 'CPM', '<size><width>1</width><height>1</height><isAspectRatio>false</isAspectRatio></size><creativeTemplateId>10004520</creativeTemplateId><expectedCreativeCount>1</expectedCreativeCount><creativeSizeType>NATIVE</creativeSizeType>', 'true', 'LIFETIME', 'IMPRESSIONS', '500000', '<geoTargeting><targetedLocations><id>2840</id><type>COUNTRY</type><displayName>United States</displayName></targetedLocations><targetedLocations><id>20123</id><type>PROVINCE</type><canonicalParentId>2124</canonicalParentId><displayName>Quebec</displayName></targetedLocations><excludedLocations><id>1016367</id><type>CITY</type><canonicalParentId>21147</canonicalParentId><displayName>Chicago</displayName></excludedLocations><excludedLocations><id>200501</id><type>DMA_REGION</type><canonicalParentId>2840</canonicalParentId><displayName>New York NY</displayName></excludedLocations></geoTargeting>', '<inventoryTargeting><targetedPlacementIds>28544791</targetedPlacementIds></inventoryTargeting>')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Artículos de línea] SET DeliveryRateType = 'EVENLY' WHERE ID = '4377540922'
Borrar

Puede eliminar una fila de LineItem especificando la columna ID.

DELETE FROM [Artículos de línea] WHERE ID = '4377865094'
Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero Identifica de forma única el elemento de línea. Este atributo es de solo lectura y lo asigna Google cuando se crea una línea de pedido.
ExternalId Long Verdadero Un identificador para LineItem que sea significativo para el editor.
Name String Falso El nombre de la línea de pedido. Este atributo es obligatorio y tiene una longitud máxima de 255 caracteres.
OrderId Long Falso El ID del Pedido al que pertenece el LineItem. Este atributo es obligatorio.
OrderName String Verdadero El nombre de la Orden. Este valor es de solo lectura.
StartDateTime Datetime Falso La fecha y la hora en que se habilita el elemento de línea para comenzar a publicarse. Este atributo es obligatorio a menos que LineItem.StartDateTimeType se establezca en INMEDIATAMENTE o UNA_HORA_DE_AHORA.
StartTimeZoneId String Falso El identificador de zona horaria de fecha de inicio del elemento de línea. El ID de la zona horaria debe estar en formato de base de datos tz (por ejemplo, America/Los_Angeles).
StartDateTimeType String Falso Especifica si se debe comenzar a publicar el elemento de línea de inmediato, en una hora, etc. Los valores permitidos son USE_START_DATE_TIME, IMMEDIATELY, ONE_HOUR_FROM_NOW, UNKNOWN.
EndDateTime Datetime Falso La fecha y la hora en que el elemento de línea dejará de publicarse. Este atributo es obligatorio a menos que LineItem.unlimitedEndDateTime se establezca en verdadero. Si se especifica, debe ser posterior a LineItem.startDateTime. Esta fecha y hora de finalización no incluye los días de extensión automática.
EndTimeZoneId String Falso El ID de la zona horaria de la fecha de finalización del elemento de línea. El ID de la zona horaria debe estar en formato de base de datos tz (por ejemplo, America/Los_Angeles).
AutoExtensionDays Integer Verdadero El número de días para permitir que una línea de pedido se entregue después de su endDateTime. Se permite un máximo de 7 días. Esta es una función premium disponible para las líneas de pedido LineItemType.STANDARD.
UnlimitedEndDateTime Boolean Verdadero Especifica si LineItem tiene o no una hora de finalización. Este atributo es opcional y su valor predeterminado es falso. Se puede configurar como verdadero solo para elementos de línea de tipo LineItemType.SPONSORSHIP, LineItemType.NETWORK, LineItemType.PRICE_PRIORITY y LineItemType.HOUSE.
CreativeRotationType String Falso La estrategia utilizada para mostrar varios objetos creativos que están asociados con el elemento de línea. Este atributo es obligatorio. Los valores permitidos son EVEN, OPTIMIZED, MANUAL, SEQUENTIAL.
DeliveryRateType String Falso La estrategia para publicar anuncios a lo largo de la duración de la línea de pedido. Este atributo es opcional y el valor predeterminado es DeliveryRateType.EVENLY o DeliveryRateType.FRONTLOADED según la configuración de la red. Los valores permitidos son EVENLY, FRONTLOADED, AS_FAST_AS_POSSIBLE.
RoadblockingType String Verdadero La estrategia para publicar creatividades roadblocked, es decir, instancias en las que se deben publicar varias creatividades juntas en una sola página web. Este atributo es opcional y el valor predeterminado es RoadblockingType.ONE_OR_MORE.
LineItemType String Falso Indica el tipo de elemento de línea de un LineItem. Este atributo es obligatorio. Los valores permitidos son PATROCINIO, ESTÁNDAR, RED, GRANEL, PRICE_PRIORITY, HOUSE, LEGACY_DFP, CLICK_TRACKING, ADSENSE, AD_EXCHANGE, BUMPER, ADMOB, UNKNOWN.
CurrencyCode String Falso Código de moneda de tres letras en formato de cadena.
MicroAmount Long Falso Los valores monetarios siempre se especifican en términos de micros, que son una millonésima parte de la unidad monetaria fundamental. Para dólares estadounidenses, $1 es 1 000 000 micros.
CostType String Falso El método utilizado para facturar este artículo de línea. Este atributo es obligatorio. Los valores permitidos son CPA, CPC, CPD, CPM, UNKNOWN, VCPM.
Priority Integer Verdadero La prioridad de la línea de pedido. Los valores válidos van del 1 al 16. Este campo es opcional y tiene por defecto la prioridad predeterminada de LineItemType.
CreativePlaceholdersAggregate String Falso Detalles sobre las creatividades que se espera que se publiquen a través de esta línea de pedido. Este atributo es obligatorio y reemplaza el atributo creativeSizes.
DiscountType String Verdadero El tipo de descuento que se aplica a un elemento de línea, ya sea basado en porcentaje o absoluto. Este atributo es opcional y su valor predeterminado es LineItemDiscountType.PERCENTAGE.
Discount Double Verdadero El número aquí es un porcentaje o un valor absoluto según LineItemDiscountType. Si LineItemDiscountType es LineItemDiscountType.PERCENTAGE, solo se admiten valores no fraccionarios.
ContractedUnitsBought Integer Verdadero Este atributo solo se aplica a determinados tipos de elementos de línea y actúa como información o nota, lo que no afecta a la publicación de anuncios ni a otros sistemas backend.
EnvironmentType String Verdadero El ambiente al que apunta LineItem. El valor predeterminado es EnvironmentType.BROWSER. Si este valor es EnvironmentType.VIDEO_PLAYER, esta línea de pedido solo puede segmentar AdUnits que tengan AdUnitSizes cuyo tipo de ambiente también sea VIDEO_PLAYER.
CompanionDeliveryOption String Verdadero La opción de entrega para acompañantes
CreativePersistenceType String Verdadero Especifica opciones para evitar que los anuncios se reemplacen o aparezcan con este elemento de línea.
AllowOverbook Boolean Falso La marca indica si se debe permitir la sobreventa al crear o actualizar reservas de tipos de elementos de línea LineItemType.SPONSORSHIP y LineItemType.STANDARD. Cuando es verdadero, las operaciones en esta línea de pedido nunca generarán un ForecastError, que corresponde a una advertencia de sobreventa en la interfaz de usuario. El valor predeterminado es falso.
SkipInventoryCheck Boolean Verdadero La bandera indica si se debe omitir la verificación de inventario al realizar una acción en esta línea de pedido. El valor predeterminado es falso.
SkipCrossSellingRuleWarningChecks Boolean Verdadero True para omitir las comprobaciones de las advertencias de las reglas aplicadas a las líneas de pedido que tienen como objetivo el inventario compartido por un socio distribuidor para la venta cruzada al realizar una acción en esta línea de pedido. El valor predeterminado es falso.
ReserveAtCreation Boolean Verdadero La marca indica si se debe reservar el inventario al crear una línea de pedido de tipo LineItemType.SPONSORSHIP y LineItemType.STANDARD en un pedido no aprobado. El valor predeterminado es falso.
Status String Verdadero El estado del elemento de línea. Este atributo es de solo lectura.
ReservationStatus String Verdadero Describe si se ha reservado o no inventario para el elemento de línea. Este atributo es de solo lectura y lo asigna Google.
IsArchived Boolean Verdadero El estado de archivo del LineItem. Este atributo es de solo lectura.
DisableSameAdvertiserCompetitiveExclusion Boolean Verdadero Si una línea de pedido tiene una serie de exclusiones competitivas, podría bloquearse para que no se publique con líneas de pedido del mismo anunciante. Establecer esto en verdadero permitirá que las líneas de pedido del mismo anunciante se publiquen independientemente de las otras etiquetas de exclusión competitiva que se apliquen.
LastModifiedByApp String Verdadero La aplicación que modificó por última vez este elemento de línea. Este atributo es de solo lectura y lo asigna Google.
Notes String Verdadero Proporciona cualquier nota adicional que pueda anotar el elemento de línea. Este atributo es opcional y tiene una longitud máxima de 65.535 caracteres.
LastModifiedDateTime Datetime Verdadero La fecha y la hora en que se modificó por última vez esta línea de pedido.
CreationDateTime Datetime Verdadero Este atributo puede ser nulo para las líneas de pedido creadas antes de que se introdujera esta función.
IsPrioritizedPreferredDealsEnabled Boolean Verdadero Si una línea de pedido de AdExchange ha priorizado las ofertas preferidas habilitadas. Este atributo es opcional y su valor predeterminado es falso.
AdExchangeAuctionOpeningPriority Integer Verdadero La prioridad con la que una línea de pedido de Ad Exchange entra en la subasta abierta de Ad Exchange si la oferta preferida no se realiza. Este atributo es opcional. Si las ofertas preferidas priorizadas están habilitadas, el valor predeterminado es 12. De lo contrario, se ignora.
IsSetTopBoxEnabled Boolean Verdadero Marca que especifica si este elemento de línea es un elemento de línea habilitado para decodificador. Las líneas de pedido de decodificadores solo admiten los siguientes tamaños de creatividad: 1920 x 1080 y 640 x 480.
IsMissingCreatives Boolean Verdadero Indica si a un LineItem le faltan creatividades para los creativePlaceholders especificados.
VideoMaxDuration Integer Verdadero La duración máxima de una creatividad de video asociada con este elemento de línea en milisegundos. Este atributo es opcional, el valor predeterminado es 0 y solo tiene sentido si se trata de una línea de pedido de video.
GoalType String Falso El tipo de objetivo para el elemento de línea. Define el período durante el cual se debe alcanzar el objetivo de LineItem. Los valores permitidos son NINGUNO, DE POR VIDA, DIARIO, DESCONOCIDO.
GoalUnitType String Falso El tipo de la unidad de objetivo para el elemento de línea. Los valores permitidos son IMPRESSIONS, CLICKS, CLICK_THROUGH_CPA_CONVERSIONS, VIEW_THROUGH_CPA_CONVERSIONS, TOTAL_CPA_CONVERSIONS, UNKNOWN, VIEWABLE_IMPRESSIONS.
GoalUnits Integer Falso Si este es un objetivo principal, representa la cantidad o el porcentaje de impresiones o clics que se reservarán para el elemento de línea.
GeoTargetingAggregate String Falso Especifica las ubicaciones geográficas a las que apunta LineItem. Este atributo es opcional.
InventoryTargetingAggregate String Falso Especifica qué inventario es el objetivo de LineItem. Este atributo es obligatorio. La línea de pedido debe orientar al menos un bloque de anuncios o una ubicación.
CustomFieldName String Verdadero Este es el nombre del campo personalizado. Habrá tantas columnas personalizadas como campos personalizados estén relacionados con LineItems.

Aplicaciones Móviles

Crear y consultar aplicaciones móviles de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de MobileApplications. Por ejemplo:

SELECT * FROM [MobileApplications]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Aplicaciones móviles] WHERE ID = '370450571'
Insertar

Para crear una nueva aplicación móvil, se requieren los campos DisplayName, AppStoreId y AppStore.

INSERT INTO [Aplicaciones móviles] (DisplayName, AppStoreId, AppStore) VALUES ('Netflix', 'com.netflix.mediaclient', 'GOOGLE_PLAY')
Actualizar

La operación de actualización no es compatible con esta tabla.

Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero Identifica de forma única la aplicación móvil. Este atributo es de solo lectura y lo asigna Google cuando se reclama una aplicación móvil.
DisplayName String Falso El nombre para mostrar de la aplicación móvil. Este atributo es obligatorio y tiene una longitud máxima de 255 caracteres.
AppStoreId String Falso El ID de la tienda de aplicaciones de la aplicación para reclamar. Este atributo es necesario para la creación y luego es de solo lectura.
AppStore String Falso La tienda de aplicaciones a la que pertenece la aplicación móvil. Este atributo es necesario para la creación y luego es de solo lectura. Los valores permitidos son GOOGLE_PLAY, APPLE_ITUNES, UNKNOWN.
IsArchived Boolean Verdadero El estado de archivo de la aplicación móvil. Este atributo es de solo lectura.
AppStoreName String Verdadero El nombre de la aplicación en la tienda de aplicaciones. Este atributo es de solo lectura y lo rellena Google.
DeveloperName String Verdadero El nombre del desarrollador de la aplicación móvil. Este atributo es de solo lectura y lo rellena Google.
Platform String Verdadero La plataforma en la que se ejecuta la aplicación móvil. Este atributo es de solo lectura y lo rellena Google.
IsFree Boolean Verdadero Si la aplicación móvil es gratuita en la tienda de aplicaciones a la que pertenece. Este atributo es de solo lectura y lo completa Google.
DownloadUrl String Verdadero La URL de descarga de la aplicación móvil en la tienda de aplicaciones a la que pertenece. Este atributo es de solo lectura y lo rellena Google.

Pedidos

Cree, actualice, elimine y consultar pedidos de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de pedidos. Por ejemplo:

SELECT * FROM [Orders ]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Pedidos] WHERE ID = '2112977260'
Insertar

Para crear un nuevo pedido, se requieren los campos Nombre, AdvertiserId, TraffickerId y CreatorId.

INSERT INTO [Pedidos] (Name, AdvertiserId, TraffickerId, CreatorId) VALUES ('Ord313', '4410125029', '244525926' ,'244525926')
Actualizar

Puede actualizar las notas de una fila de pedido especificando la columna ID.

UPDATE [Pedidos] SET Notes = 'Updated notes22222' WHERE ID = '2112977260'
Borrar

Puede eliminar una fila de pedido especificando la columna ID.

DELETE FROM [Pedidos] WHERE ID = '2108997295'
Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Falso El ID único de la Orden. Este valor es de solo lectura y lo asigna Google.
Name String Falso El nombre de la Orden. Este valor es obligatorio para crear un pedido y tiene una longitud máxima de 255 caracteres.
Status String Falso El estado de la Orden. Este atributo es de solo lectura.
StartDateTime Datetime Verdadero La fecha y la hora en que el Pedido y sus líneas de pedido asociadas son elegibles para comenzar a publicarse. Este atributo es de solo lectura y se deriva del elemento de línea del pedido que tiene el LineItem.startDateTime más antiguo.
EndDateTime Datetime Verdadero La fecha y la hora en que el Pedido y sus elementos de línea asociados dejan de entregarse. Este atributo es de solo lectura y se deriva del elemento de línea del pedido que tiene el LineItem.endDateTime más reciente.
UnlimitedEndDateTime Boolean Falso Especifica si el Pedido tiene o no una fecha de finalización ilimitada. Este atributo es de solo lectura y es verdadero si alguno de los elementos de línea del pedido tiene LineItem.unlimitedEndDateTime establecido en verdadero.
IsArchived Boolean Falso El estado de archivo de la Orden. Este atributo es de solo lectura.
ExternalOrderId Long Falso Una ID arbitraria para asociar a la Orden, que puede usarse como clave para un sistema externo. Este valor es opcional.
CurrencyCode String Falso Proporciona cualquier nota adicional que pueda anotar la Orden. Este atributo es opcional y tiene una longitud máxima de 65.535 caracteres.
AdvertiserId Long Falso El ID único de la Empresa, que es de tipo Empresa.Tipo.ANUNCIANTE, a la que pertenece este pedido. Este atributo es obligatorio.
AdvertiserContactIds Long Falso Lista de ID para los contactos del anunciante del pedido.
AgencyId Long Falso El ID único de la empresa, que es de tipo Company.Type.AGENCY, con la que está asociado este pedido. Este atributo es opcional.
CreatorId Long Falso La identificación única del Usuario que creó el Pedido en nombre del anunciante. Este valor es de solo lectura y lo asigna Google.
TraffickerId Long Falso El ID único del Usuario responsable del tráfico del Pedido. Este valor es obligatorio para crear un pedido
Notes String Falso Proporciona cualquier nota adicional que pueda anotar la Orden. Este atributo es opcional y tiene una longitud máxima de 65.535 caracteres.
TotalImpressionsDelivered Long Falso Impresiones totales entregadas para todas las líneas de pedido de este pedido. Este valor es de solo lectura y lo asigna Google.
TotalClicksDelivered Long Falso Clics totales entregados para todas las líneas de pedido de este pedido. Este valor es de solo lectura y lo asigna Google.
TotalViewableImpressionsDelivered Long Falso Impresiones visibles totales entregadas para todas las líneas de pedido de este pedido. Este valor es de solo lectura y lo asigna Google. A partir de v201705, esto será nulo cuando el pedido no tenga elementos de línea traficados con respecto a un objetivo de impresiones visibles.
TotalBudget Integer Falso Presupuesto total para todas las partidas de este pedido. Este valor es un campo de solo lectura asignado por Google y se calcula a partir de los valores LineItem.costPerUnit asociados.
LastModifiedByApp String Falso La aplicación que modificó este pedido. Este atributo es de solo lectura y lo asigna Google.
IsProgrammatic Boolean Falso Especifica si el pedido es o no un pedido programático. Este valor es opcional y el valor predeterminado es falso.
LastModifiedDateTime Datetime Verdadero La fecha y hora en que se modificó por última vez este pedido.
CustomFieldName String Verdadero Este es el nombre del campo personalizado. Habrá tantas columnas personalizadas como campos personalizados estén relacionados con los pedidos.

Ubicaciones

Cree, actualice, elimine y consultar ubicaciones de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de ubicaciones. Por ejemplo:

SELECT * FROM [Placements]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Ubicaciones] WHERE ID = '28544791'
Insertar

Para crear una nueva ubicación, los campos Nombre, Descripción y TargetedAdUnitIds son obligatorios.

INSERT INTO [Ubicaciones] (Name, Description, TargetedAdUnitIds) VALUES ('placement', 'testtttttttt', '21622217303,21622217300')
Actualizar

Puede actualizar cualquier campo que no esté marcado como de solo lectura especificando la columna ID.

UPDATE [Ubicaciones] SET Name = 'New Placement', Description = 'New Description' WHERE ID = '28544791'
Borrar

La operación de eliminación no es compatible con esta tabla.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero Identifica de forma única la ubicación. Este atributo es de solo lectura y lo asigna Google cuando se crea una ubicación.
Name String Falso El nombre de la ubicación. Este valor es obligatorio y tiene una longitud máxima de 255 caracteres.
Description String Falso Una descripción de la colocación. Este valor es opcional y su longitud máxima es de 65.535 caracteres.
PlacementCode String Verdadero Una cadena utilizada para identificar de forma única la ubicación con el fin de servir el anuncio. Este atributo es de solo lectura y lo asigna Google cuando se crea una ubicación.
Status String Verdadero El estado de la Colocación. Este atributo es de solo lectura.
IsAdSenseTargetingEnabled Boolean Verdadero Describe si la ubicación está disponible para la orientación del sitio por parte de los anunciantes de AdWords.
TargetedAdUnitIds String Falso La colección de ID de objetos de AdUnit que constituyen la ubicación.
LastModifiedDateTime Datetime Verdadero La fecha y la hora en que se modificó por última vez esta ubicación.

Elementos de Línea de Propuesta

Cree, actualice y consultar DoubleClick for Publishers ProposalLineItems.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero El ID único de ProposalLineItem. Este atributo es de solo lectura.
ProposalId Long Verdadero El ID único de la Propuesta, al que pertenece el ProposalLineItem. Este atributo es necesario para la creación y luego es de solo lectura.
Name String Falso El nombre del ProposalLineItem que debe ser único en la misma Propuesta. Este atributo tiene una longitud máxima de 255 caracteres. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
StartDateTime Datetime Falso La fecha y la hora en que la línea de pedido asociada con ProposalLineItem está habilitada para comenzar a publicarse. Este atributo es opcional durante la creación, pero obligatorio y debe serlo en el futuro cuando se convierta en una línea de pedido. Se requiere DateTime.timeZoneID si la hora de la fecha de inicio no es nula. Este atributo pasa a ser de solo lectura una vez que ProposalLineItem ha comenzado a entregar.
EndDateTime Datetime Falso La fecha y la hora en que la línea de pedido asociada con ProposalLineItem deja de publicarse. Este atributo es opcional durante la creación, pero obligatorio y debe ser posterior a startDateTime. Se requiere DateTime.timeZoneID si la fecha de finalización no es nula.
TimeZoneId String Falso El Id. de huso horario en formato de base de datos tz (por ejemplo, 'America/Los_Angeles') para este ProposalLineItem. El número de días de servicio se calcula en esta huso horario. Entonces, si rateType es RateType.CPD, afectará el cálculo del costo. startDateTime y endDateTime se devolverán en esta huso horario. Este atributo es opcional y tiene como valor predeterminado la huso horario de la red. Este atributo es de solo lectura cuando se usa programática garantizada, usando administración de ventas, o cuando se usa programática garantizada, sin usar administración de ventas.
InternalNotes String Falso Proporciona notas adicionales que pueden anotar el ProposalLineItem. Este atributo es opcional y tiene una longitud máxima de 65.535 caracteres. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
IsArchived Boolean Verdadero El estado de archivo de ProposalLineItem. Este atributo es de solo lectura.
ContractedUnitsBought Long Falso El número de impresiones o clics contratados. Si se trata de un LineItemType.SPONSORSHIP ProposalLineItem, tiene RateType.CPD como tipo de tarifa y isProgrammatic es falso, esto representa la impresión mínima de por vida. Si se trata de un LineItemType.SPONSORSHIP ProposalLineItem, tiene RateType.CPD como tipo de tarifa y isProgrammatic es verdadero, esto representa la impresión mínima diaria. Este atributo es obligatorio para las líneas de pedido de propuesta basadas en objetivos porcentuales. No afecta la publicación de anuncios y solo tiene fines informativos.
DeliveryRateType String Falso La estrategia para publicar anuncios durante el transcurso de la duración de ProposalLineItem. Este atributo es opcional y el valor predeterminado es DeliveryRateType.EVENLY. Para un ProposalLineItem de oferta preferida, el valor solo puede ser DeliveryRateType.FRONTLOADED. Los valores permitidos son EVENLY, FRONTLOADED, AS_FAST_AS_POSSIBLE.
RoadblockingType String Falso La estrategia para publicar creatividades roadblocked, es decir, instancias en las que se deben publicar varias creatividades juntas en una sola página web. Este atributo es opcional durante la creación y el valor predeterminado es el tipo de roadblock del producto o RoadblockingType.ONE_OR_MORE si el producto no lo especifica. Los valores permitidos son ONLY_ONE, ONE_OR_MORE, AS_MANY_AS_POSSIBLE, ALL_ROADBLOCK, CREATIVE_SET.
CompanionDeliveryOption String Falso La opción de entrega para acompañantes. Esto solo es válido si el tipo de publicación simultánea es RoadblockingType.CREATIVE_SET. El valor predeterminado para las creatividades de roadblock es CompanionDeliveryOption.OPTIONAL. El valor predeterminado en otros casos es CompanionDeliveryOption.UNKNOWN. Proporcionar algo que no sea CompanionDeliveryOption.UNKNOWN provocará un error. Los valores permitidos son OPCIONAL, AL MENOS_UNO, TODOS, DESCONOCIDO.
VideoMaxDuration Long Falso La duración máxima de una creatividad de video asociada con este ProposalLineItem en milisegundos. Este atributo es opcional, el valor predeterminado es Product.videoMaxDuration en el producto con el que se creó y solo es significativo si se trata de una línea de pedido de propuesta de video.
VideoCreativeSkippableAdType String Falso La saltabilidad de las creatividades de la línea de pedido de propuesta. Este atributo es opcional, solo se aplica a las líneas de pedido de propuesta de video y su valor predeterminado es SkippableAdType.NOT_SKIPPABLE. Los valores permitidos son UNKNOWN, DISABLED, ENABLED, INSTREAM_SELECT, ANY.
DfpLineItemId Long Verdadero El ID único del elemento de línea correspondiente. Será nulo si la propuesta no se envió a Ad Manager. Este atributo es de solo lectura.
LineItemType String Falso El LineItemType correspondiente del ProposalLineItem. Para una ProposalLineItem programática, el valor solo puede ser uno de los siguientes: LineItemType.SPONSORSHIP, LineItemType.STANDARD, LineItemType.PREFERRED_DEAL Los valores permitidos son SPONSORSHIP, STANDARD, NETWORK, BULK, PRICE_PRIORITY, HOUSE, LEGACY_DFP, CLICK_TRACKING, ADSENSE, AD_EXCHANGE, BUMPER, ADMOB, PREFERRED_DEAL, DESCONOCIDO.
LineItemPriority Int Falso La prioridad para el LineItem correspondiente del ProposalLineItem. Este atributo es opcional durante la creación y tiene como valor predeterminado la prioridad del producto o un valor predeterminado asignado por Google. Consulte LineItem.priority para obtener más información.
RateType String Falso El método utilizado para facturar el ProposalLineItem. Los valores permitidos son CPM, CPC, CPD, CPU, FLAT_FEE, VCPM, CPM_IN_TARGET, UNKNOWN.
DisableSameAdvertiserCompetitiveExclusion Boolean Falso Si una línea de pedido tiene una serie de exclusiones competitivas, podría bloquearse para que no se publique con líneas de pedido del mismo anunciante. Establecer esto en verdadero permitirá que las líneas de pedido del mismo anunciante se publiquen independientemente de las otras etiquetas de exclusión competitiva que se apliquen. Este atributo es opcional y su valor predeterminado es falso.
IsSold Boolean Verdadero Indica si este ProposalLineItem se ha vendido. Este atributo es de solo lectura.
ComputedStatus String Verdadero El estado de la línea de pedido generada a partir de esta línea de pedido de propuesta. Será nulo si la línea de pedido de propuesta no se envió a Ad Manager. Este atributo es de solo lectura.
LastModifiedDateTime Datetime Verdadero La fecha y la hora en que se modificó por última vez este ProposalLineItem. Google asigna este atributo cuando se actualiza un ProposalLineItem. Este atributo es de solo lectura.
ReservationStatus String Verdadero El estado de la reserva del ProposalLineItem. Este atributo es de solo lectura.
LastReservationDateTime Datetime Verdadero El último DateTime cuando ProposalLineItem reservó el inventario. Este atributo es de solo lectura.
EnvironmentType String Falso El ambiente al que se dirige ProposalLineItem. El valor predeterminado es EnvironmentType.BROWSER. Si este valor es EnvironmentType.VIDEO_PLAYER, entonces este ProposalLineItem solo puede orientar bloques de anuncios que tengan tamaños cuyo AdUnitSize.environmentType también sea EnvironmentType.VIDEO_PLAYER. Este campo solo se puede cambiar si linkStatus es LinkStatus.UNLINKED. De lo contrario, su valor es de solo lectura y se establece en Product.environmentType del producto a partir del cual se creó esta línea de pedido de propuesta. Los valores permitidos son NAVEGADOR, VIDEO_PLAYER.
AllowedFormats String Falso El conjunto de formatos permitidos que puede tener esta línea de pedido de propuesta. Si el conjunto está vacío, esta línea de pedido de propuesta permite todos los formatos. Los valores permitidos son AUDIO, DESCONOCIDO.
IsProgrammatic Boolean Verdadero Si la Propuesta para este ProposalLineItem es o no un acuerdo programático. Este atributo se rellena desde Proposal.isProgrammatic. Este atributo es de solo lectura.
AdditionalTerms String Falso Términos adicionales que se muestran al comprador en Marketplace.
ProgrammaticCreativeSource String Falso Indica el ProgrammaticCreativeSource de la línea de pedido programática. Los valores permitidos son EDITOR, ANUNCIANTE, DESCONOCIDO.
EstimatedMinimumImpressions Long Falso Las impresiones mínimas estimadas que se deben entregar para una línea de pedido de propuesta.
HasMakegood Boolean Verdadero Si esta línea de pedido de propuesta tiene una compensación asociada. Este atributo es de solo lectura.
CanCreateMakegood Boolean Verdadero Si se puede crear una nueva compensación asociada con este elemento de línea. Este atributo es de solo lectura.

Propuestas

Crear, actualizar y consultar propuestas de DoubleClick for Publishers.

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero El ID único de la propuesta. Este atributo es de solo lectura.
IsProgrammatic Boolean Falso Indicador que especifica si esta Propuesta es para acuerdos programáticos. Este valor es falso por defecto.
DfpOrderId Long Verdadero El ID único del pedido correspondiente. Será nulo si la propuesta no se envió a Ad Manager. Este atributo es de solo lectura.
StartDateTime Datetime Verdadero La fecha y la hora en que el pedido y las líneas de pedido asociadas con la Propuesta son elegibles para comenzar a publicarse. Este atributo se deriva de la línea de pedido de la propuesta que tiene el ProposalLineItem.startDateTime más antiguo. Este atributo será nulo si esta propuesta no tiene elementos de línea relacionados o si ninguno de sus elementos de línea tiene una hora de inicio. Este atributo es de solo lectura.
EndDateTime Datetime Verdadero La fecha y la hora en que el pedido y las líneas de pedido asociadas con la Propuesta dejan de entregarse. Este atributo se deriva de la línea de pedido de la propuesta que tiene el ProposalLineItem.endDateTime más reciente. Este atributo será nulo si esta propuesta no tiene elementos de línea relacionados o si ninguno de sus elementos de línea tiene una hora de finalización. Este atributo es de solo lectura.
Name String Falso El nombre de la Propuesta. Este valor tiene una longitud máxima de 255 caracteres. Este valor se copia en Order.name cuando la propuesta se convierte en un pedido. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
Status String Verdadero El estado de la Propuesta. Este atributo es de solo lectura.
IsArchived Boolean Verdadero El estado de archivo de la Propuesta. Este atributo es de solo lectura.
InternalNotes String Falso Proporciona cualquier nota adicional que pueda anotar la Propuesta. Este atributo es opcional y tiene una longitud máxima de 65.535 caracteres. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
SalesPlannerIds Long Verdadero Lista de ID únicos de objetos de Usuario que son los planificadores de ventas de la Propuesta. Este atributo es opcional. Una propuesta podría tener 8 planificadores de ventas como máximo. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
PrimaryTraffickerId Long Falso La identificación única del Usuario que es el coordinador de publicidad principal y es responsable del tráfico de la Propuesta. Este atributo es obligatorio cuando la propuesta se convierte en un pedido y se copiará en Order.primaryTraffickerId. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
SellerContactIds Long Verdadero usuarios que son los contactos del vendedor. Este atributo es aplicable cuando se usa programática garantizada, usando administración de ventas, o cuando se usa programática garantizada, sin usar administración de ventas, o cuando se usan ofertas preferidas, sin usar administración de ventas.
AppliedTeamIds Long Verdadero Los ID de todos los equipos en los que se encuentra la Propuesta directamente. Este atributo es opcional. Este atributo se puede configurar como editable después de que se haya enviado la propuesta. Consulte con su administrador de red para la configuración de campos editables.
CurrencyCode String Falso El código de moneda de esta Propuesta. Este atributo es opcional y tiene como valor predeterminado el código de moneda de la red.
IsSold Boolean Verdadero Indica si la propuesta ha sido vendida, es decir, corresponde a si el estado de un Pedido es OrderStatus.APROVED o OrderStatus.PAUSED. Este atributo es de solo lectura.
LastModifiedDateTime Datetime Verdadero La fecha y hora en que se modificó por última vez esta Propuesta. Este atributo es de solo lectura.
HasBuyerRfp Boolean Falso Si una Propuesta contiene un campo BuyerRfp. Si este campo es verdadero, indica que la Propuesta en cuestión se originó de un comprador. Este atributo es aplicable cuando se usa la programática garantizada, no se usa la administración de ventas, o cuando se usan acuerdos preferenciales, no se usa la administración de ventas.
DeliveryPausingEnabled Boolean Falso Si se consiente la pausa de la Propuesta. Este campo es opcional y su valor predeterminado es verdadero. Si es falso, indica que el comprador y el vendedor están de acuerdo en que la propuesta no debe pausarse.

Usuarios

Crear, actualizar, eliminar y consultar usuarios de DoubleClick for Publishers.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de Usuarios. Por ejemplo:

SELECT * FROM [Users]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Usuarios] WHERE ID = '244555723'
Insertar

Para crear un nuevo usuario, se requieren los campos Nombre, Correo e Id. de rol.

INSERT INTO [Usuarios] (Name, Email, RoleId) VALUES ('murat', 'email@gmail.com', '-1')
Actualizar

Puede actualizar cualquier columna que no esté marcada como de solo lectura especificando la columna ID.

UPDATE [Usuarios] SET Name = 'New User' WHERE ID = '244555723'
Borrar

Puede eliminar una fila de usuario especificando la columna ID.

DELETE FROM [Usuarios] WHERE ID = '244555723'
Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] Long Verdadero La identificación única del Usuario. Este atributo es de solo lectura y lo asigna Google.
Name String Falso El nombre del usuario. Tiene una longitud máxima de 128 caracteres.
Email String Falso El correo o login del Usuario. Para crear un nuevo usuario, ya debe tener una cuenta de Google.
RoleId Long Falso El ID de rol único del usuario. Los roles creados por Google tendrán ID negativos.
RoleName String Verdadero El nombre del rol asignado al Usuario. Este atributo es de solo lectura.
IsActive Boolean Verdadero Especifica si el usuario está activo o no. Un usuario inactivo no puede iniciar sesión en el sistema ni realizar ninguna operación. Este atributo es de solo lectura.
IsEmailNotificationAllowed Boolean Verdadero Especifica si el usuario desea o no permitir que el sistema de anuncios de display del editor envíe notificaciones correo a su dirección de correo. Este atributo es opcional y su valor predeterminado es verdadero.
IsServiceAccount Boolean Verdadero Si el usuario es un usuario de cuenta de servicio OAuth2. Este atributo es de solo lectura. Los usuarios de la cuenta de servicio solo se pueden agregar a través de la interfaz de usuario.

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas del Administrador de Google Ads

Nombre Descripción
DeliveryReport Consultar informes de entrega de DoubleClick for Publishers.
InventoryReport Consulta los informes de inventario de DoubleClick for Publishers.
Roles Consulta DoubleClick para funciones de editores.
SalesReport Consulta los informes de ventas de DoubleClick for Publishers.

Informe de Entrega

Consultar informes de entrega de DoubleClick for Publishers.

Seleccionar

Representa un trabajo de informe que se ejecutará para recuperar información estadística y de rendimiento sobre las entregas. De forma predeterminada, el informe recuperará los datos del último mes. Especifique StartDate y EndDate para ejecutar el informe en el período de tiempo deseado. Por ejemplo:

SELECT * FROM [Informe de entrega] WHERE StartDate = '01-01-2018' AND EndDate = '01-02-2018'
Columnas
Nombre Tipo Descripción
OrderId String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
OrderName String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerImpressions Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerClicks Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerCtr Double Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerCpmAndCpcRevenue Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerWithoutCpdAverageEcpm Double Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
OrderTrafficker String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
OrderStartDateTime Datetime Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
OrderEndDateTtime Datetime Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Nombre Tipo Descripción
EndDate Date La fecha de finalización del intervalo de fechas personalizado. La fecha de finalización no puede ser posterior a la fecha de hoy.
StartDate Date La fecha de inicio del intervalo de fechas personalizado. La fecha de inicio debe ser anterior o igual a la fecha de finalización.
DateRangeType String El período de tiempo durante el cual se generan los datos del informe. Los valores admitidos son: HOY, AYER, ÚLTIMA_SEMANA, ÚLTIMO_MES, ÚLTIMO_3_MESES, ALCANCE_DE_VIDA, FECHA_PERSONALIZADA, PRÓXIMO_DÍA, PRÓXIMO_90_DÍAS, PRÓXIMA_SEMANA, PRÓXIMO_MES, ACTUAL_Y_PRÓXIMO_MES, PRÓXIMO_TRIMESTRE, PRÓXIMOS_3_MESES, PRÓXIMOS_12_MESES. Para definir períodos de tiempo personalizados, establezca esto en CUSTOM_DATE.

Reporte de Inventario

Consulta los informes de inventario de DoubleClick for Publishers.

Seleccionar

Representa un trabajo de informe que se ejecutará para recuperar información estadística y de rendimiento sobre los inventarios. De forma predeterminada, el informe recuperará los datos del último mes. Especifique StartDate y EndDate para ejecutar el informe en el período de tiempo deseado. Por ejemplo:

SELECT * FROM [Reporte de inventario] WHERE StartDate = '01-01-2018' AND EndDate = '01-02-2018'
Columnas
Nombre Tipo Descripción
AdUnitId String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdUnitName String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerImpressions Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerClicks Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
DynamicAllocationInventoryLevelImpressions Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
DynamicAllocationInventoryLevelClicks Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
TotalInventoryLevelImpressions Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
TotalInventoryLevelCpmAndCpcRevenue Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Nombre Tipo Descripción
EndDate Date La fecha de finalización del intervalo de fechas personalizado. La fecha de finalización no puede ser posterior a la fecha de hoy.
StartDate Date La fecha de inicio del intervalo de fechas personalizado. La fecha de inicio debe ser anterior o igual a la fecha de finalización.
DateRangeType String El período de tiempo durante el cual se generan los datos del informe. Los valores admitidos son: HOY, AYER, ÚLTIMA_SEMANA, ÚLTIMO_MES, ÚLTIMO_3_MESES, ALCANCE_DE_VIDA, FECHA_PERSONALIZADA, PRÓXIMO_DÍA, PRÓXIMO_90_DÍAS, PRÓXIMA_SEMANA, PRÓXIMO_MES, ACTUAL_Y_PRÓXIMO_MES, PRÓXIMO_TRIMESTRE, PRÓXIMOS_3_MESES, PRÓXIMOS_12_MESES. Para definir períodos de tiempo personalizados, establezca esto en CUSTOM_DATE

Roles

Consulta DoubleClick para funciones de editores.

Seleccionar

Las siguientes consultas se procesan en el lado del servidor mediante las APIs de Google Ad Manager. El conector procesa otras consultas SELECT del lado del cliente en la memoria.

Recuperar una lista de Roles. Por ejemplo:

SELECT * FROM [Roles]

Además, puede especificar el ID o filtrar por cualquier otra columna.

SELECT * FROM [Funciones] WHERE ID = '-28'
Columnas
Nombre Tipo Descripción
Id [KEY] Long El ID único del rol. Este valor es de solo lectura y lo asigna Google. Los roles creados por Google tendrán ID negativos.
Name String El nombre del rol. Este valor es de solo lectura y lo asigna Google.
Description String La descripción del rol. Este valor es de solo lectura y lo asigna Google.
Status String El estado del Rol. Este campo es de solo lectura y puede tener los valores RoleStatus.ACTIVE (predeterminado) o RoleStatus.INACTIVE, que determina la visibilidad del rol en la interfaz de usuario.

Reporte de Ventas

Consulta los informes de ventas de DoubleClick for Publishers.

Seleccionar

Representa un trabajo de informe que se ejecutará para recuperar información de rendimiento y estadísticas sobre las ventas. De forma predeterminada, el informe recuperará los datos del último mes. Especifique StartDate y EndDate para ejecutar el informe en el período de tiempo deseado. Por ejemplo:

SELECT * FROM [Reporte de ventas] WHERE StartDate = '01-01-2018' AND EndDate = '01-02-2018'
Columnas
Nombre Tipo Descripción
SalesPersonId String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
SalesPersonName String Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerImpressions Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerCpmAndCpcRevenue Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
AdServerWithoutCpdAverageEcpm Long Esta columna se asigna al campo del mismo nombre en la API de DoubleClick for Publishers.
Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Nombre Tipo Descripción
EndDate Date La fecha de finalización del intervalo de fechas personalizado. La fecha de finalización no puede ser posterior a la fecha de hoy.
StartDate Date La fecha de inicio del intervalo de fechas personalizado. La fecha de inicio debe ser anterior o igual a la fecha de finalización.
DateRangeType String El período de tiempo durante el cual se generan los datos del informe. Los valores admitidos son: HOY, AYER, ÚLTIMA_SEMANA, ÚLTIMO_MES, ÚLTIMO_3_MESES, ALCANCE_DE_VIDA, FECHA_PERSONALIZADA, PRÓXIMO_DÍA, PRÓXIMO_90_DÍAS, PRÓXIMA_SEMANA, PRÓXIMO_MES, ACTUAL_Y_PRÓXIMO_MES, PRÓXIMO_TRIMESTRE, PRÓXIMOS_3_MESES, PRÓXIMOS_12_MESES. Para definir períodos de tiempo personalizados, establezca esto en CUSTOM_DATE.

Procedimientos Almacenados

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Jitterbit Connector para Procedimientos Almacenados de Google Ads Manager

Nombre Descripción
CreateReportSchema Cree un esquema para un informe personalizado.
GetOAuthAccessToken Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.
GetOAuthAuthorizationURL Obtiene la URL de autorización de OAuth utilizada para la autenticación con varios servicios de Google.
RefreshOAuthAccessToken Actualiza el token de acceso de OAuth utilizado para la autenticación con varios servicios de Google.

CreateReportSchema

Cree un esquema para un informe personalizado.

Aporte
Nombre Tipo Obligatorio Descripción
ReportName String Cierto El nombre del informe.
FileName String Cierto La ruta completa del archivo y el nombre del esquema a generar. Ej: 'C:/Users/User/Desktop/SampleReport.rsd'
Metrics String Cierto Métricas del informe separadas por coma. Ej: 'AD_SERVER_IMPRESSIONS, AD_SERVER_TARGETED_IMPRESSIONS, AD_SERVER_CLICKS, AD_SERVER_TARGETED_CLICKS'
Dimensions String Cierto Dimensiones del informe separadas por coma. Ej: 'MES_Y_AÑO, SEMANA, FECHA, DÍA'
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Devuelve True si se crea el informe.

Obtener Token de Acceso de OAuth

Obtiene el token de acceso de OAuth que se utilizará para la autenticación con varios servicios de Google.

Aporte
Nombre Tipo Obligatorio Descripción
AuthMode String Cierto El tipo de modo de autenticación a utilizar. Los valores permitidos son APP, WEB. El valor predeterminado es WEB.
Verifier String Falso El código verificador devuelto por Google después de que se haya otorgado el permiso para que la aplicación se conecte. Solo modo de autenticación WEB.
Scope String Cierto El alcance del acceso a las APIs de Google. De forma predeterminada, se especificará el acceso a todas las APIs utilizadas por este proveedor de datos. El valor predeterminado es *https://www.googleapis.com/auth/dfp*.
CallbackURL String Falso Este campo determina dónde se envía la respuesta. El valor de este parámetro debe coincidir exactamente con uno de los valores registrados en la consola de APIs, incluidos los esquemas HTTP o HTTPS, las mayúsculas y la barra diagonal final ('/').
Prompt String Cierto Este campo indica el aviso para presentar al usuario. Acepta uno de los siguientes valores: NINGUNO, CONSENTIMIENTO, SELECCIONAR CUENTA. El valor predeterminado es SELECT_ACCOUNT, por lo que se le pedirá a un usuario determinado que seleccione la cuenta a la que conectarse. Si se establece en CONSENTIMIENTO, el usuario verá una página de consentimiento cada vez, incluso si previamente ha dado su consentimiento a la aplicación para un conjunto determinado de ámbitos. Por último, si se establece en NINGUNO, no se mostrarán pantallas de autenticación o consentimiento al usuario. El valor predeterminado es SELECT_ACCOUNT.
AccessType String Cierto Este campo indica si su aplicación necesita acceder a una API de Google cuando el usuario no está presente en el navegador. Este parámetro está predeterminado en FUERA DE LÍNEA. Si su aplicación necesita actualizar los tokens de acceso cuando el usuario no está presente en el navegador, use OFFLINE. Esto hará que su aplicación obtenga un token de actualización la primera vez que intercambie un código de autorización para un usuario. Los valores permitidos son ONLINE, OFFLINE. El valor predeterminado es FUERA DE LÍNEA.
State String Falso Este campo indica cualquier estado que pueda ser útil para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Google y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto por Google. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String Un token que puede usarse para obtener un nuevo token de acceso.
ExpiresIn String El tiempo de vida restante en el token de acceso.

Obtener URL de Autorización de OAuth

Obtiene la URL de autorización de OAuth utilizada para la autenticación con varios servicios de Google.

Aporte
Nombre Tipo Obligatorio Descripción
Scope String Cierto El alcance del acceso a las APIs de Google. De forma predeterminada, se especificará el acceso a todas las APIs utilizadas por este proveedor de datos. El valor predeterminado es *https://www.googleapis.com/auth/dfp https://www.google.com/m8/feeds/*.
CallbackURL String Falso Este campo determina dónde se envía la respuesta. El valor de este parámetro debe coincidir exactamente con uno de los valores registrados en la consola de APIs, incluidos los esquemas HTTP o HTTPS, las mayúsculas y la barra diagonal final ('/').
Prompt String Cierto Este campo indica el aviso para presentar al usuario. Acepta uno de los siguientes valores: NINGUNO, CONSENTIMIENTO, SELECCIONAR CUENTA. El valor predeterminado es SELECT_ACCOUNT, por lo que se le pedirá a un usuario determinado que seleccione la cuenta a la que conectarse. Si se establece en CONSENTIMIENTO, el usuario verá una página de consentimiento cada vez, incluso si previamente ha dado su consentimiento a la aplicación para un conjunto determinado de ámbitos. Por último, si se establece en NINGUNO, no se mostrarán pantallas de autenticación o consentimiento al usuario. El valor predeterminado es SELECT_ACCOUNT.
AccessType String Cierto Este campo indica si su aplicación necesita acceder a una API de Google cuando el usuario no está presente en el navegador. Este parámetro está predeterminado en FUERA DE LÍNEA. Si su aplicación necesita actualizar los tokens de acceso cuando el usuario no está presente en el navegador, use OFFLINE. Esto hará que su aplicación obtenga un token de actualización la primera vez que intercambie un código de autorización para un usuario. Los valores permitidos son ONLINE, OFFLINE. El valor predeterminado es FUERA DE LÍNEA.
State String Falso Este campo indica cualquier estado que pueda ser útil para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Google y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
URL String La URL para completar la autenticación del usuario.

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con varios servicios de Google.

Aporte
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Cierto El token de actualización devuelto del intercambio de código de autorización original.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto por Google. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String Un token que puede usarse para obtener un nuevo token de acceso.
ExpiresIn String El tiempo de vida restante en el token de acceso.

Tablas del Sistema

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema

Las siguientes tablas devuelven metadatos de la base de datos para Google Ad Manager:

Tablas de Fuentes de Datos

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

  • sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
  • sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consulta

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

  • identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.

Sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.
SchemaName String El nombre del esquema.

Sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista.
TableType String El tipo de tabla (tabla o vista).
Description String Una descripción de la tabla o vista.
IsUpdateable Boolean Si la tabla se puede actualizar.

Sys_tablecolumns

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla Pedidos:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Orders' 
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista que contiene la columna.
ColumnName String El nombre de la columna.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El tamaño de almacenamiento de la columna.
DisplaySize Int32 El ancho máximo normal de la columna designada en caracteres.
NumericPrecision Int32 El número máximo de dígitos en datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 La escala de columna o número de dígitos a la derecha del punto decimal.
IsNullable Boolean Si la columna puede contener nulo.
Description String Una breve descripción de la columna.
Ordinal Int32 El número de secuencia de la columna.
IsAutoIncrement String Si el valor de la columna se asigna en incrementos fijos.
IsGeneratedColumn String Si se genera la columna.
IsHidden Boolean Si la columna está oculta.
IsArray Boolean Si la columna es una matriz.

Sys_procedimientos

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene el procedimiento almacenado.
SchemaName String El esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado.
Description String Una descripción del procedimiento almacenado.
ProcedureType String El tipo de procedimiento, como PROCEDIMIENTO o FUNCIÓN.

Sys_procedureparameters

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SelectEntries:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el procedimiento almacenado.
SchemaName String El nombre del esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado* que contiene el parámetro.
ColumnName String El nombre del procedimiento almacenado* parámetro.
Direction Int32 Un número entero correspondiente al tipo de parámetro: entrada (1), entrada/salida (2) o salida (4). Los parámetros de tipo de entrada/salida pueden ser tanto parámetros de entrada como de salida.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El número de caracteres permitidos para los datos de caracteres. El número de dígitos permitidos para datos numéricos.
NumericPrecision Int32 La máxima precisión para datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 El número de dígitos a la derecha del punto decimal en datos numéricos.
IsNullable Boolean Si el parámetro puede contener nulo.
IsRequired Boolean Si el parámetro es necesario para la ejecución del procedimiento.
IsArray Boolean Si el parámetro es una matriz.
Description String La descripción del parámetro.
Ordinal Int32 El índice del parámetro.

Sys_keycolumns

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla Pedidos:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Orders'
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
IsKey Boolean Si la columna es una clave principal en la tabla a la que se hace referencia en el campo TableName.
IsForeignKey Boolean Si la columna es una clave externa a la que se hace referencia en el campo TableName.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.

Sys_foreignkeys

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.
ForeignKeyType String Designa si la clave externa es una clave de importación (apunta a otras tablas) o de exportación (hace referencia desde otras tablas).

Sys_indexes

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el índice.
SchemaName String El nombre del esquema que contiene el índice.
TableName String El nombre de la tabla que contiene el índice.
IndexName String El nombre del índice.
ColumnName String El nombre de la columna asociada con el índice.
IsUnique Boolean True si el índice es único. Falso en caso contrario.
IsPrimary Boolean True si el índice es una clave principal. Falso en caso contrario.
Type Int16 Un valor entero correspondiente al tipo de índice: estadística (0), agrupado (1), hash (2) u otro (3).
SortOrder String El orden de clasificación: A para ascender o D para descender.
OrdinalPosition Int16 El número de secuencia de la columna en el índice.

Sys_connection_props

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:googleadsmanager:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''
Columnas
Nombre Tipo Descripción
Name String El nombre de la propiedad de conexión.
ShortDescription String Una breve descripción.
Type String El tipo de datos de la propiedad de conexión.
Default String El valor predeterminado si no se establece uno explícitamente.
Values String Una lista separada por comas de valores posibles. Se lanza un error de validación si se especifica otro valor.
Value String El valor que establezca o un valor predeterminado preconfigurado.
Required Boolean Si la propiedad es necesaria para conectarse.
Category String La categoría de la propiedad de conexión.
IsSessionProperty String Si la propiedad es una propiedad de sesión, utilizada para guardar información sobre la conexión actual.
Sensitivity String El nivel de sensibilidad de la propiedad. Esto informa si la propiedad está ofuscada en los formularios de registro y autenticación.
PropertyName String Una forma truncada en mayúsculas y minúsculas del nombre de la propiedad de conexión.
Ordinal Int32 El índice del parámetro.
CatOrdinal Int32 El índice de la categoría de parámetro.
Hierarchy String Muestra las propiedades dependientes asociadas que deben configurarse junto con esta.
Visible Boolean Informa si la propiedad está visible en la interfaz de usuario de la conexión.
ETC String Diversa información miscelánea sobre la propiedad.

Sys_sqlinfo

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento Colaborativo de Consultas

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

Nombre Descripción Valores posibles
AGGREGATE_FUNCTIONS Funciones de agregación admitidas. AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT Si se admite la función COUNT. YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR El carácter de apertura utilizado para escapar de un identificador. [
IDENTIFIER_QUOTE_CLOSE_CHAR El carácter de cierre utilizado para escapar de un identificador. ]
SUPPORTED_OPERATORS Una lista de operadores de SQL admitidos. =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY Si se admite GROUP BY y, de ser así, el grado de compatibilidad. NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
STRING_FUNCTIONS Funciones de cadena admitidas. LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS Funciones numéricas compatibles. ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS Funciones de fecha/hora admitidas. NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES Indica tablas omitidas durante la replicación.
REPLICATION_TIMECHECK_COLUMNS Una matriz de cadenas que contiene una lista de columnas que se usarán para verificar (en el orden dado) para usar como una columna modificada durante la replicación.
IDENTIFIER_PATTERN Valor de cadena que indica qué cadena es válida para un identificador.
SUPPORT_TRANSACTION Indica si el proveedor admite transacciones como compromiso y reversión. YES, NO
DIALECT Indica el dialecto SQL a usar.
KEY_PROPERTIES Indica las propiedades que identifican la base de datos uniforme.
SUPPORTS_MULTIPLE_SCHEMAS Indica si pueden existir varios esquemas para el proveedor. YES, NO
SUPPORTS_MULTIPLE_CATALOGS Indica si pueden existir varios catálogos para el proveedor. YES, NO
DATASYNCVERSION La versión de sincronización de datos necesaria para acceder a este controlador. Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY La categoría Sincronización de datos de este controlador. Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL Si se admite la funcionalidad de SQL mejorada más allá de lo que ofrece la API. TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS Si se admiten las operaciones lote. YES, NO
SQL_CAP Todas las funciones de SQL admitidas para este controlador. SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS Un valor de cadena especifica las cacheOptions preferidas.
ENABLE_EF_ADVANCED_QUERY Indica si el controlador admite directamente consultas avanzadas provenientes de Entity Framework. De lo contrario, las consultas se manejarán del lado del cliente. YES, NO
PSEUDO_COLUMNS Una matriz de cadenas que indica las pseudocolumnas disponibles.
MERGE_ALWAYS Si el valor es verdadero, el modo de combinación se ejecuta a la fuerza en la sincronización de datos. TRUE, FALSE
REPLICATION_MIN_DATE_QUERY Una consultar de selección para devolver la fecha y hora de inicio de la réplica.
REPLICATION_MIN_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un min del lado del servidor.
REPLICATION_START_DATE Permite que un proveedor especifique una fecha de inicio de réplica.
REPLICATION_MAX_DATE_QUERY Una consultar de selección para devolver la fecha y hora de finalización de la réplica.
REPLICATION_MAX_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un máx. del lado del servidor.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE Una lista de tablas que omitirán dividir la réplica en fragmentos en la réplica inicial.
CHECKCACHE_USE_PARENTID Indica si la instrucción CheckCache debe realizarse en la columna de clave principal. TRUE, FALSE
CREATE_SCHEMA_PROCEDURES Indica procedimientos almacenados* que se puede utilizar para generar archivos de esquema.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas
Nombre Tipo Descripción
NAME String Un componente de la sintaxis SQL o una capacidad que se puede procesar en el servidor.
VALUE String Detalles sobre el SQL o la sintaxis de SQL admitidos.

Sys_identidad

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity
Columnas
Nombre Tipo Descripción
Id String El ID generado por la base de datos devuelto de una operación de modificación de datos.
Batch String Un identificador para el lote. 1 para una sola operación.
Operation String El resultado de la operación en el lote: INSERTADO, ACTUALIZADO o ELIMINADO.
Message String ÉXITO o un mensaje de error si falla la actualización en el lote.

Propiedades de Configuraciones Avanzadas

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a Google Ad Manager.
NetworkCode Obtenga este valor de la URL después de iniciar sesión en la red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.
Version La última versión de Google Ad Manager Api.

OAuth

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

JWT OAuth

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

SSL

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Esquema

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Misceláneas

Propiedad Descripción
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
Pagesize El número máximo de resultados por página de Google Ad Manager.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Autenticación

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a Google Ad Manager.
NetworkCode Obtenga este valor de la URL después de iniciar sesión en la red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.
Version La última versión de Google Ad Manager Api.

AuthScheme

El tipo de autenticación que se utilizará al conectarse a Google Ad Manager.

Valores Posibles

Auto, OAuth, OAuthJWT, GCPInstanceAccount

Tipo de Datos

string

Valor por Defecto

"Auto"

Observaciones
  • Automático: permite que el controlador decida automáticamente según las otras propiedades de conexión que haya establecido.
  • OAuth: Configure esto para realizar la autenticación OAuth usando una cuenta de usuario estándar.
  • OAuthJWT: Configure esto para realizar la autenticación OAuth usando una cuenta de servicio OAuth.
  • GCPInstanceAccount: configure esto para obtener el token de acceso de la instancia de Google Cloud Platform.

Código de Red

Obtenga este valor de la URL después de iniciar sesión en la red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El NetWorkCode debe establecerse en la cadena de conexión. Encontrará esto en la URL cuando inicie sesión en su red. Por ejemplo, en la URL https://www.google.com/dfp/2032576#delivery, 2032576 es su código de red.

Versión

La última versión de Google Ad Manager Api.

Tipo de Datos

string

Valor por Defecto

"v202202"

Observaciones

La última versión de Google Ad Manager Api. Encontrará esto en la página de documentación de su API.

OAuth

Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Iniciar OAuth

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores Posibles

OFF, GETANDREFRESH, REFRESH

Tipo de Datos

string

Valor por Defecto

"OFF"

Observaciones

Las siguientes opciones están disponibles:

  1. OFF: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
  2. GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.
  3. REFRESH: indica que el conector solo manejará la actualización de OAuthAccessToken. El conector nunca le pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.

OAuthClientId

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

OAuthClientSecretOAuthClientSecret

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también denominada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto del cliente en OAuthClientSecret propiedad.

Token de Acceso de OAuth

El token de acceso para conectarse mediante OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthAccessToken la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.

OAuthVerifier

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en Máquinas Sin Cabeza

Ver para obtener el OAuthVerifier valor.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia el OAuthVerifier para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth para GETANDREFRESH automatizar el intercambio.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthRefreshToken la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn

La vida útil en segundos del AccessToken de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

OAuthTokenTimestamp

La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

JWT OAuth

Esta sección proporciona una lista completa de las propiedades de JWT OAuth que puede configurar.

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

OAuthJWTCert

El almacén de certificados JWT.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El nombre del almacén de certificados para el certificado de cliente.

El OAuthJWTCertType especifica el tipo de almacén de certificados especificado por OAuthJWTCert. Si la tienda está protegida con contraseña, especifique la contraseña en OAuthJWTCertPassword.

OAuthJWTCert se usa junto con OAuthJWTCertSubject para especificar certificados de cliente. Si OAuthJWTCert tiene un valor y OAuthJWTCertSubject, se inicia una búsqueda de un certificado. Consulte OAuthJWTCertSubject campo para más detalles.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

Propiedad Descripción
MY Un almacén de certificados que contiene certificados personales con sus claves privadas asociadas.
CA Certificados de la autoridad certificadora.
ROOT Certificados raíz.
SPC Certificados de editor de software.

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (es decir, almacén de certificados PKCS12).

OAuthJWTCertType

El tipo de almacén de claves que contiene el certificado JWT.

Valores Posibles

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB, GOOGLEJSON, GOOGLEJSONBLOB

Tipo de Datos

string

Valor por Defecto

"USER"

Observaciones

Esta propiedad puede tomar uno de los siguientes valores:

Propiedad Descripción
USER Para Windows, esto especifica que el almacén de certificados es un almacén de certificados propiedad del usuario actual. Nota: Este tipo de tienda no está disponible en Java.
MACHINE Para Windows, esto especifica que el almacén de certificados es un almacén de máquinas. Nota: este tipo de tienda no está disponible en Java.
PFXFILE El almacén de certificados es el nombre de un archivo PFX (PKCS12) que contiene certificados.
PFXBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato PFX (PKCS12).
JKSFILE El almacén de certificados es el nombre de un archivo de almacén de claves Java (JKS) que contiene certificados. Nota: este tipo de tienda solo está disponible en Java.
JKSBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato de almacén de claves Java (JKS). Nota: este tipo de tienda solo está disponible en Java.
PEMKEY_FILE El almacén de certificados es el nombre de un archivo con codificación PEM que contiene una clave privada y un certificado opcional.
PEMKEY_BLOB El almacén de certificados es una cadena (codificada en base64) que contiene una clave privada y un certificado opcional.
PUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene un certificado de clave pública con codificación PEM o DER.
PUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene un certificado de clave pública con codificación PEM o DER.
SSHPUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene una clave pública de estilo SSH.
SSHPUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene una clave pública de estilo SSH.
P7BFILE El almacén de certificados es el nombre de un archivo PKCS7 que contiene certificados.
PPKFILE El almacén de certificados es el nombre de un archivo que contiene una PPK (clave privada PuTTY).
XMLFILE El almacén de certificados es el nombre de un archivo que contiene un certificado en formato XML.
XMLBLOB El almacén de certificados es una cadena que contiene un certificado en formato XML.
GOOGLEJSON El almacén de certificados es el nombre de un archivo JSON que contiene la información de la cuenta de servicio. Solo válido cuando se conecta a un servicio de Google.
GOOGLEJSONBLOB El almacén de certificados es una cadena que contiene la cuenta de servicio JSON. Solo válido cuando se conecta a un servicio de Google.

OAuthJWTCertPassword

La contraseña para el certificado OAuth JWT.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se usa para especificar esa contraseña para abrir el almacén de certificados.

Esto no es necesario cuando se usa GOOGLEJSON OAuthJWTCertType. Las claves JSON de Google no están cifradas.

OAuthJWTCertSubject

El asunto del certificado OAuth JWT.

Tipo de Datos

string

Valor por Defecto

"\*"

Observaciones

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad.

Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@jitterbit.com". Los campos comunes y sus significados se muestran a continuación.

Campo Significado
CN Nombre común. Este es comúnmente un nombre de alojar como www.server.com.
O Organización
OU Unidad organizativa
L localidad
S Estado
C País
E Dirección de Correo

Si un valor de campo contiene una coma, debe estar entre comillas.

OAuthJWTIssuer

El emisor del token web de Java.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El emisor del token web de Java. Suele ser el ID del cliente o la dirección de Correo de la aplicación OAuth.

Esto no es necesario cuando se usa GOOGLEJSON OAuthJWTCertType. Las claves JSON de Google contienen una copia de la cuenta del emisor.

OAuthJWTAsunto

El sujeto de usuario para el que la aplicación solicita acceso delegado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El sujeto de usuario para el que la aplicación solicita acceso delegado. Por lo general, el nombre de la cuenta de usuario o la dirección de correo.

SSL

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

SSLServerCert

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Descripción Ejemplo
Un certificado PEM completo (ejemplo abreviado por brevedad) -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
Una ruta a un archivo local que contiene el certificado C:\cert.cer
La clave pública (ejemplo abreviado por brevedad) -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
La huella digital MD5 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) ecadbdda5a1529c58a1e9e09828d70e4
La huella digital SHA1 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) 34a929226ae0819f2ec14b4a3d904f801cbb150d

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Ubicación

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos

string

Valor por Defecto

"%APPDATA%\\\GoogleAdsManager Data Provider\\Schema"

Observaciones

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\GoogleAdsManager Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Plataforma %APPDATA%
Windows El valor de la variable de ambiente APPDATA
Mac ~/Biblioteca/Soporte de aplicaciones
Linux ~/.config

Esquemas Navegables

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Misceláneas

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Propiedad Descripción
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
Pagesize El número máximo de resultados por página de Google Ad Manager.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Filas Máximas

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos

int

Valor por Defecto

-1

Observaciones

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo
Propiedad Descripción
DefaultColumnSize Establece la longitud predeterminada de los campos de cadena cuando la fuente de datos no proporciona la longitud de columna en los metadatos. El valor predeterminado es 2000.
ConvertDateTimeToGMT Determina si se convierten los valores de fecha y hora a GMT, en lugar de la hora local de la máquina.
RecordToFile=filename Registra la transferencia de datos del socket subyacente al archivo especificado.

Tamaño de Página

El número máximo de resultados por página de Google Ad Manager.

Tipo de Datos

int

Valor por Defecto

100

Observaciones

El Pagesize la propiedad afecta la cantidad máxima de resultados que se devuelven por página desde Google Ad Manager. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.

Pseudocolumnas

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Se Acabó el Tiempo

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos

int

Valor por Defecto

60

Observaciones

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.