AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Funciones Google
  • Propiedades específicas de la descripción de las variables gglConnection
  • Requisitos previos para la autenticación OAuth 2.0
  • Persistencia de la conexión
  • Funciones que utilizan un gglConnection Variable
  • Funciones (sintaxis prefijada) que las variables manipular gglConnection
  • Sintaxis compatible hasta abril de 2015 (puede utilizarse con versiones anteriores a la versión 20)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 App
Otros
Procedimientos almacenados
gglConnection (Tipo de Variable)
 
El tipo gglConnection se utiliza para describir una conexión a los servicios de Google y para administrar la autenticación a los diferentes servicios. Las características de esta conexión pueden ser definidas y modificadas por varias propiedades de WLanguage.
Observación: Consulte Declarar una variable para obtener más detalles sobre la declaración de este tipo de variables y el uso de propiedades WLanguage.
Ejemplo
// CAUTION: FROM VERSION 20, THE GGLCONNECTION TYPE CHANGES
// Connection
Cnt is gglConnection
Cnt..Email = "email_final_user@gmail.com"
Cnt..ClientID = "387756281032-qffa6dajjd5348iqhi558dkd98xxxxxx.apps.googleusercontent.com"
Cnt..ClientSecret = "S13DCA6KkYh1EgPv9-jLxxxh"
IF GglConnect(Cnt) = False THEN
Error(ErrorInfo())
END
Observaciones

Propiedades específicas de la descripción de las variables gglConnection

Las siguientes propiedades pueden ser utilizadas para manipular una conexión de Google:
denominarTipo utilizado Efecto
ClientIDCadena de caracteresIdentificador de cliente dado al declarar la aplicación en la consola de Google.
ClientSecretCadena de caracteresCódigo secreto del cliente dado al declarar la aplicación en la consola de Google.
EmailCadena de caracteresEmail del cliente final. Este Property es opcional. Este Property se usa para rellenar previamente la ventana de acceso del cliente a su cuenta de Google.
Atención: Este Property no puede ser usado para recuperar la cuenta Email de la cuenta autentificada.
Observación: Estas propiedades se pueden utilizar con una de las siguientes sintaxis:
  • <Nombre de la variable>..<Nombre de la propiedad>
  • <Nombre de la variable>.<Nombre de la propiedad>

Requisitos previos para la autenticación OAuth 2.0

Para conectarse con la autenticación OAuth 2.0, la aplicación debe estar declarada en la consola del desarrollador de Google.: https://developers.google.com/console. En la consola:
  1. Haga clic en "Crear un proyecto".. Indique el nombre de su proyecto. Se propone automáticamente un identificador para su proyecto.
  2. Valide
  3. Se crea el proyecto.
  4. En el menú de la izquierda, haga clic en "API and authentication" y luego en "API"..
  5. Seleccione los servicios requeridos por la aplicación:
    • Para acceder a los Calendar s, elija "Calendar API" (categoría "Google Apps API s").
    • Para acceder a los contactos, seleccione "Contactos API" (categoría "Google Apps API s")..
    • Para acceder a los documentos de Google, seleccione "Drive API" (categoría "Google Apps API s")..
    • Para acceder a los álbumes de Picasa y a los documentos, no es necesario seleccionar un API específico..
  6. En el menú de la izquierda, haga clic en "Identificadores"..
  7. A continuación, haga clic en el botón "Crear un identificador de cliente.
    • Seleccione el tipo de aplicación: "Aplicación instalada".
    • La pantalla de autorización debe configurarse durante la primera creación del identificador de cliente..
    • En la pantalla de autorización, en el área "Nombre del producto", introduzca el nombre de su solicitud, por ejemplo.
    • Haga clic en "Guardar"..
    • Se vuelve a visualizar la pantalla para crear el identificador de cliente..
      • Valide. Se crean los identificadores de cliente:
        • Identificación del cliente. Este identificador debe almacenarse. Se utilizará en el gglConnection Variable.
        • Código secreto del cliente. Este identificador debe almacenarse. Se utilizará en el gglConnection Variable.
        • WINDEV Mobile Redirección URI. Compruebe si se especifica "http://localhost"..

    Persistencia de la conexión

    Durante la conexión a los servicios de Google, los tokens de autenticación no se guardan.. Por lo tanto, es necesario volver a iniciar sesión y volver a autorizar el acceso a la aplicación cada vez que se ejecuta (es decir, cada vez que se utiliza un gglConnection Variable "en blanco").
    Para que la autorización de acceso sea persistente, todo lo que tiene que hacer es llamar a las funciones de serialización de WLanguage.
    Ejemplo de implementación de la persistencia utilizando un archivo XML:
    let sAuthPersistenceFile = SysDir(srLocalAppData) + [fSep] + "gglauth.xml"

    cnt is gglConnection
    // If connection already established
    IF fFileExist(sAuthPersistenceFile) THEN
    // Restore the connection
    let bufDeserialize = fLoadBuffer(sAuthPersistenceFile)
    Deserialize(cnt, bufDeserialize, psdXML)
    ELSE
    // New connection
    cnt.Email = "email@gmail.com"
    cnt.ClientID = "387756281032-qffa6dajjd5348iqhi558xxxxxxxx.apps.googleusercontent.com"
    cnt.ClientSecret = "Sxxxxx-jLMwwh"
    END

    IF GglConnect(cnt, gglCalendarService) THEN
    // Save the connection in order to re-use it later
    bufSerialize is Buffer
    Serialize(cnt, bufSerialize, psdXML)
    fSaveBuffer(sAuthPersistenceFile, bufSerialize)
    END
    Remark: Las fichas de autenticación de un gglConnection Variable se pueden autorizar a través de GglDesconectar.

    Funciones que utilizan un gglConnection Variable

    Todas las funciones para comunicarse con los servicios de Google tienen como parámetro una variable de tipo gglConnection.
    GglConnectLe permite autenticarse en un servidor de Google..
    GglDeleteElimina los datos del servidor de Google.
    GglDisconnectDesconecta al usuario de los servicios de Google utilizados.. Durante la próxima reconexión, se volverán a solicitar las autorizaciones de relacionado a los servicios de Google.
    GglFillCalendarLlena un Calendar que fue recuperado de antemano: se recuperan los eventos correspondientes a la Calendar (se pueden especificar algunos criterios).
    GglFillCalendarByRequestLlena un Calendar que fue recuperado de antemano: los eventos correspondientes a la Calendar se recuperan de una solicitud personalizada.
    GglGetCalendarRecupera un Google Calendar y sus eventos según su título o identificador.
    GglGetDocumentDescarga un Document del servicio de Google Docs.
    GglListCalendarRecupera la lista de calendarios de Google associated con la cuenta de Google especificada.
    GglListContactRecupera la lista de contactos de associated con la cuenta de Google especificada.
    GglListContactByRequestRecupera una lista de contactos a partir de parámetros personalizados.
    GglListContactoGrupoRecupera la lista de grupos de contactos de associated con la cuenta de Google especificada.
    GglListDocumentRecupera la lista de documentos disponibles en el servidor de Google para el usuario actual.
    GglRequestEnvía una solicitud de comunicación (solicitud HTTP) a un servicio de Google.
    GglUploadDocumentSube una Document al servidor de Google.
    GglWriteCrea y/o actualiza datos en el servidor de Google (adición o modificación de datos).

    Funciones (sintaxis prefijada) que las variables manipular gglConnection

    <gglConnection Variable>.BorrarElimina los datos del servidor de Google.
    <gglConnection Variable>.DesconectarDesconecta al usuario de los servicios de Google utilizados.. Durante la próxima reconexión, se volverán a solicitar las autorizaciones de relacionado a los servicios de Google.
    <gglConnection Variable>.EscribirCrea y/o actualiza datos en el servidor de Google (adición o modificación de datos).
    <gglConnection Variable>.FillCalendarLlena un Calendar que fue recuperado de antemano: se recuperan los eventos correspondientes a la Calendar (se pueden especificar algunos criterios).
    <gglConnection Variable>.GetCalendarRecupera un Google Calendar y sus eventos según su título o identificador.
    <gglConnection Variable>.SolicitudEnvía una solicitud de comunicación (solicitud HTTP) a un servicio de Google.
    <gglConnection Variable>.ListContactarPorSolicitudRecupera una lista de contactos a partir de parámetros personalizados.
    <gglConnection Variable>.UploadDocumentoSube una Document al servidor de Google.
    <gglConnection Variable>.ListContactRecupera la lista de contactos de associated con la cuenta de Google especificada.
    <gglConnection Variable>.ListDocumentoRecupera la lista de documentos disponibles en el servidor de Google para el usuario actual.
    <Variable gglConnection>.FillCalendarByRequestLlena un Calendar que fue recuperado de antemano: los eventos correspondientes a la Calendar se recuperan de una solicitud personalizada.
    <Variable gglConnection>.GetDocumentDescarga un Document del servicio de Google Docs.
    <Variable gglConnection>.ListContactGroupRecupera la lista de grupos de contactos de associated con la cuenta de Google especificada.
    <Variable gglConnectiongt;.ListCalendarRecupera la lista de calendarios de Google associated con la cuenta de Google especificada.

    Sintaxis compatible hasta abril de 2015 (puede utilizarse con versiones anteriores a la versión 20)

    Hasta abril de 2015, tiene la posibilidad de utilizar la siguiente sintaxis:
    <Result> = GglConnect(Google Connection>)
    donde <Conexión Google> es una variable de tipo gglConnection compuesta de las siguientes propiedades:
    denominarTipo utilizado Efecto
    EmailCadena de caracteresGoogle email Address del usuario (corresponde a su login).
    ContraseñaCadena de caracteresContraseña de Connection.
    Nombre de la aplicaciónCadena de caracteresNombre de la aplicación. Este Property puede corresponder a una cadena vacía.
    // SYNTAX OBSOLETE FROM APRIL 2015

    // Connection
    Cnt is gglConnection
    Cnt..Email = "vince@gmail.com"
    Cnt..Password = "azerty"
    Cnt..ApplicationName = "MyApp-03"
    IF GglConnect(Cnt) = False THEN
    Error(ErrorInfo())
    END
    Versión mínima requerida
    • Versión 14
    Esta página también está disponible para…
    Comentarios
    Haga clic en [Agregar] para publicar un comentario

    Última modificación: 27/01/2023

    Señalar un error o enviar una sugerencia | Ayuda local