|
|
|
|
- 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)
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.
// 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: | | | denominar | Tipo utilizado | Efecto |
---|
ClientID | Cadena de caracteres | Identificador de cliente dado al declarar la aplicación en la consola de Google. | ClientSecret | Cadena de caracteres | Código secreto del cliente dado al declarar la aplicación en la consola de Google. | Email | Cadena de caracteres | Email 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 - Haga clic en "Crear un proyecto".. Indique el nombre de su proyecto. Se propone automáticamente un identificador para su proyecto.
- Valide
- Se crea el proyecto.
- En el menú de la izquierda, haga clic en "API and authentication" y luego en "API"..
- 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..
- En el menú de la izquierda, haga clic en "Identificadores"..
- 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.
- 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.
| | GglConnect | Le permite autenticarse en un servidor de Google.. | GglDelete | Elimina los datos del servidor de Google. | GglDisconnect | Desconecta 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. | GglFillCalendar | Llena un Calendar que fue recuperado de antemano: se recuperan los eventos correspondientes a la Calendar (se pueden especificar algunos criterios). | GglFillCalendarByRequest | Llena un Calendar que fue recuperado de antemano: los eventos correspondientes a la Calendar se recuperan de una solicitud personalizada. | GglGetCalendar | Recupera un Google Calendar y sus eventos según su título o identificador. | GglGetDocument | Descarga un Document del servicio de Google Docs. | GglListCalendar | Recupera la lista de calendarios de Google associated con la cuenta de Google especificada. | GglListContact | Recupera la lista de contactos de associated con la cuenta de Google especificada. | GglListContactByRequest | Recupera una lista de contactos a partir de parámetros personalizados. | GglListContactoGrupo | Recupera la lista de grupos de contactos de associated con la cuenta de Google especificada. | GglListDocument | Recupera la lista de documentos disponibles en el servidor de Google para el usuario actual. | GglRequest | Envía una solicitud de comunicación (solicitud HTTP) a un servicio de Google. | GglUploadDocument | Sube una Document al servidor de Google. | GglWrite | Crea y/o actualiza datos en el servidor de Google (adición o modificación de datos). |
Funciones (sintaxis prefijada) que las variables manipular gglConnection 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: | | | denominar | Tipo utilizado | Efecto |
---|
Email | Cadena de caracteres | Google email Address del usuario (corresponde a su login). | Contraseña | Cadena de caracteres | Contraseña de Connection. | Nombre de la aplicación | Cadena de caracteres | Nombre 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
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|