Recurso: DataSource
Representa los metadatos de la fuente de datos. Los metadatos son suficientes para renderizar la IU y solicitar tokens de OAuth adecuados.
Representación JSON | |
---|---|
{ "name": string, "dataSourceId": string, "displayName": string, "description": string, "clientId": string, "scopes": [ string ], "transferType": enum ( |
Campos | |
---|---|
name |
Solo salida. Es el nombre del recurso de la fuente de datos. |
dataSourceId |
Es el ID de la fuente de datos. |
displayName |
Es el nombre de la fuente de datos fácil de usar. |
description |
Es la string de descripción de fuente de datos fácil de usar. |
clientId |
Es el ID de cliente de la fuente de datos que se debe usar para recibir un token de actualización. |
scopes[] |
Son los permisos de autenticación de la API para los que se debe obtener un token de actualización. Estos son los permisos que necesita una fuente de datos para preparar datos y transferirlos a BigQuery, p. ej., https://www.googleapis.com/auth/bigquery |
transferType |
Obsoleto. Este campo no tiene efecto. |
supportsMultipleTransfers |
Obsoleto. Este campo no tiene efecto. |
updateDeadlineSeconds |
Es la cantidad de segundos en que se espera una actualización de la fuente de datos antes de que el Servicio de transferencia de datos marque la transferencia como FALLIDA. |
defaultSchedule |
Es la programación predeterminada de transferencia de datos. Algunos ejemplos de programaciones válidas son los siguientes: |
supportsCustomSchedule |
Especifica si la fuente de datos admite una programación definida por el usuario o si opera con la programación predeterminada. Cuando se establece en |
parameters[] |
Son los parámetros de la fuente de datos. |
helpUrl |
Es la URL del documento de ayuda de esta fuente de datos. |
authorizationType |
Indica el tipo de autorización. |
dataRefreshType |
Especifica si la fuente de datos admite la actualización automática de datos de los últimos días y cómo se admite. Para algunas fuentes de datos, puede que los datos no se completen hasta unos días después, por lo que resulta útil actualizar los datos de forma automática. |
defaultDataRefreshWindowDays |
Es el período de actualización de datos predeterminado en días. Solo tiene sentido cuando |
manualRunsDisabled |
Inhabilita el reabastecimiento y la programación de ejecución manual de la fuente de datos. |
minimumScheduleInterval |
Es el intervalo mínimo para que el programador programe las ejecuciones. Es una duración en segundos con hasta nueve dígitos decimales, terminados en “ |
TransferType
OBSOLETO. Representa el tipo de transferencia de datos.
Enums | |
---|---|
TRANSFER_TYPE_UNSPECIFIED |
Es un marcador de posición de tipo de transferencia no válida o desconocida. |
BATCH |
Indica una transferencia de datos por lotes. |
STREAMING |
Indica una transferencia de datos de transmisión. En la actualidad, la fuente de datos de transmisión no admite varias opciones de configuración de transferencia por proyecto. |
DataSourceParameter
Representa un parámetro de fuente de datos con reglas de validación, de modo que los parámetros se puedan renderizar en la IU. Estos parámetros proporcionan fuentes de datos admitidas y, además, incluyen toda la información necesaria para el procesamiento y la validación. Por lo tanto, cualquiera que use esta API puede decidir generar formularios genéricos de IU o formularios de fuentes de datos personalizadas específicos.
Representación JSON | |
---|---|
{ "paramId": string, "displayName": string, "description": string, "type": enum ( |
Campos | |
---|---|
paramId |
Es el identificador de parámetro. |
displayName |
Es el nombre visible del parámetro en la interfaz de usuario. |
description |
Es la descripción del parámetro. |
type |
Es el tipo de parámetro. |
required |
El parámetro es obligatorio. |
repeated |
Obsoleto. Este campo no tiene efecto. |
validationRegex |
Es una expresión regular que se puede usar a fin de validar parámetros. |
allowedValues[] |
Son todos los valores posibles del parámetro. |
minValue |
Especifica el valor mínimo permitido de los valores de números enteros y dobles. |
maxValue |
Especifica el valor máximo permitido de los valores de números enteros y dobles. |
fields[] |
Obsoleto. Este campo no tiene efecto. |
validationDescription |
Es una descripción de los requisitos para este campo, en caso de que la entrada del usuario no cumpla con los patrones regex, o con los valores mínimos o máximos. |
validationHelpUrl |
Es una URL a un documento de ayuda a fin de explicar con más detalle los requisitos para la asignación de nombres. |
immutable |
No se puede cambiar después de la creación inicial. |
recurse |
Obsoleto. Este campo no tiene efecto. |
deprecated |
Si es verdadero, no debe usarse en transferencias nuevas y no debe ser visible para los usuarios. |
Tipo
Es el tipo de parámetro.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Indica un tipo no especificado. |
STRING |
Indica el parámetro de la string. |
INTEGER |
Indica un parámetro de número entero (64 bits). Se serializará en JSON como una string. |
DOUBLE |
Indica un parámetro de punto flotante de doble precisión. |
BOOLEAN |
Indica un parámetro booleano. |
RECORD |
Obsoleto. Este campo no tiene efecto. |
PLUS_PAGE |
Es el ID de una página de Google+. |
AuthorizationType
Es el tipo de autorización necesaria para esta fuente de datos.
Enums | |
---|---|
AUTHORIZATION_TYPE_UNSPECIFIED |
Indica un tipo no especificado. |
AUTHORIZATION_CODE |
Usa códigos de autorización de OAuth 2 que se puedan intercambiar por un token de actualización en el backend. |
GOOGLE_PLUS_AUTHORIZATION_CODE |
Muestra un código de autorización para una página de Google+ determinada, que se puede intercambiar por un token de actualización en el backend. |
FIRST_PARTY_OAUTH |
Usa OAuth de origen en función de las LOA de los clientes. OAuth de origen no requiere un token de actualización para obtener un token de acceso sin conexión. En su lugar, usa una aserción de JWT firmada por el cliente para recuperar un token de acceso. |
DataRefreshType
Representa la forma en que la fuente de datos admite la actualización automática de datos.
Enums | |
---|---|
DATA_REFRESH_TYPE_UNSPECIFIED |
La fuente de datos no admitirá la actualización automática de datos, que es el valor predeterminado. |
SLIDING_WINDOW |
La fuente de datos admite la actualización automática de datos, y las ejecuciones se programarán para los últimos días. No permite establecer valores personalizados para cada configuración de transferencia. |
CUSTOM_SLIDING_WINDOW |
La fuente de datos admite la actualización automática de datos, y las ejecuciones se programarán para los últimos días. Permite establecer valores personalizados para cada configuración de transferencia. |
Métodos |
|
---|---|
|
Muestra verdadero si existen credenciales válidas para la fuente de datos determinada y el usuario solicitante. |
|
Recupera una fuente de datos admitida y muestra su configuración, que se puede usar para la renderización de la IU. |
|
Enumera las fuentes de datos admitidas y muestra sus opciones de configuración, que se pueden usar para la renderización de la IU. |