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 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 de prefijo) que manipular variables de gglConnection
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal 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 definirse y modificarse mediante diferentes propiedades de WLanguage.
Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Ejemplo
// 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 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. Esta propiedad 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.

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. Validar
  3. El proyecto se crea.
  4. En el menú de la izquierda, haga clic en "API y autentificación" y luego en "API"..
  5. Seleccione los servicios requeridos por la aplicación:
    • Para acceder a los Calendar s, selecciona "Calendar API" (categoría "Google Apps API s").
    • Para acceder a los contactos, selecciona "Contactos API" (categoría "Google Apps API s").
    • Para acceder a los documentos de Google, selecciona "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 la zona "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..
      • Validar. Se crean los identificadores de cliente:
        • Identificación del cliente. Este identificador debe almacenarse. Se utilizará en la gglConnection Variable.
        • Código secreto del cliente. Este identificador debe almacenarse. Se utilizará en la gglConnection Variable.

    Persistencia de la conexión

    Al conectarse a los servicios de Google, los tokens de autenticación no se guardan. Por lo tanto, es necesario volver a identificarse y permitir el acceso a la aplicación cada vez que se ejecute (es decir, cada vez que se utilice una 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

    Observación: Los tokens de autenticación de un gglConnection Variable se pueden borrar a través de GglDesconectar 000300030003000300030002f002300.

    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.
    GglConnectGestiona la autenticación en un servidor de Google (mediante el modo de autenticación "OAuth 2.0").
    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 de prefijo) que manipular variables de gglConnection

    <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.
    .ConnectGestiona la autenticación en un servidor de Google (mediante el modo de autenticación "OAuth 2.0").
    .DeleteElimina los datos del servidor de Google.
    .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.
    .FillCalendarLlena un Calendar que fue recuperado de antemano: se recuperan los eventos correspondientes a la Calendar (se pueden especificar algunos criterios).
    .GetCalendarRecupera un Google Calendar y sus eventos según su título o identificador.
    .ListDocumentRecupera la lista de documentos disponibles en el servidor de Google para el usuario actual.
    .solicitudEnvía una solicitud de comunicación (solicitud HTTP) a un servicio de Google.
    .UploadDocumentSube una Document al servidor de Google.
    .WriteCrea y/o actualiza datos en el servidor de Google (adición o modificación de datos).
    ListContactRecupera la lista de contactos de associated con la cuenta de Google especificada.
    ListContactByRequestRecupera una lista de contactos a partir de parámetros personalizados.
    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