- Recurso: Elemento
- ItemAcl
- ItemAcl.AclInheritanceType
- Principal
- ItemMetadata
- Interacción
- Interaction.InteractionType
- SearchQualityMetadata
- ContextAttribute
- ItemStructuredData
- StructuredDataObject
- NamedProperty
- NamedProperty.IntegerValues
- NamedProperty.DoubleValues
- NamedProperty.TimestampValues
- NamedProperty.ObjectValues
- NamedProperty.EnumValues
- NamedProperty.DateValues
- NamedProperty.TextValues
- NamedProperty.HtmlValues
- ItemContent
- ItemContent.ContentFormat
- UploadItemRef
- ItemStatus
- ProcessingError
- ProcessingErrorCode
- FieldViolation
- RepositoryError
- RepositoryError.Type
- Item.ItemType
- Métodos
Recurso: Item
Representa un objeto único que es un elemento en el índice de búsqueda, como un archivo, una carpeta o un registro de base de datos.
Representación JSON |
---|
{ "name": string, "acl": { object ( |
Campos | |
---|---|
name |
Es el nombre del artículo. Formato: fuentes de datos/{sourceId}/items/{itemId} Éste es un campo obligatorio. La longitud máxima es de 1,536 caracteres. |
acl |
Lista de control de acceso para este elemento. |
metadata |
La información de los metadatos. |
structuredData |
Los datos estructurados del elemento que debe coincidir con una definición de objeto registrada en el esquema de la fuente de datos. |
content |
Contenido del elemento que se indexará y que se pueda buscar el texto. |
version |
Obligatorio. El sistema de indexación almacena la versión de la fuente de datos como una string de bytes y compara la versión del elemento en el índice con la versión del elemento en cola mediante el orden léxico. La indexación de Cloud Search no indexará ni borrará ningún elemento en cola con un valor de versión inferior o igual a la versión del elemento indexado actualmente. La longitud máxima de este campo es de 1,024 bytes. Para obtener información sobre cómo la versión del elemento afecta el proceso de eliminación, consulta el artículo Cómo manejar revisiones después de eliminaciones manuales. String codificada en base64. |
status |
Es el estado del artículo. Es el campo de solo salida. |
queue |
Fila a la que pertenece este elemento. La longitud máxima es de 100 caracteres. |
payload |
El conector de estado adicional puede almacenar este elemento. La longitud máxima es de 10,000 bytes. String codificada en base64. |
itemType |
Es el tipo de este elemento. |
ItemAcl
Información de la lista de control de acceso para el elemento. Para obtener más información, consulta Asigna LCA.
Representación JSON |
---|
{ "inheritAclFrom": string, "aclInheritanceType": enum ( |
Campos | |
---|---|
inheritAclFrom |
Es el nombre del elemento del que se hereda la lista de permisos de acceso (LCA). Nota: La herencia de LCA solo proporciona permisos de acceso a elementos secundarios y no define relaciones estructurales, ni proporciona formas convenientes de borrar grupos grandes de elementos. Borrar un elemento superior de LCA del índice solo altera los permisos de acceso de los elementos secundarios que hacen referencia al elemento superior en el campo |
aclInheritanceType |
Establece el tipo de reglas de acceso que se deben aplicar cuando un elemento hereda su LCA de un elemento superior. Siempre se debe configurar en conjunto con el campo |
readers[] |
Lista de cuentas principales que tienen permiso para ver el elemento en los resultados de la búsqueda. Opcional si se heredan permisos de otro elemento o si este no pretende ser visible, como |
deniedReaders[] |
Lista de principales a las que se les denegó de forma explícita el acceso al elemento en los resultados de la búsqueda. Si bien a las principales se les niega el acceso de forma predeterminada, usa lectores denegados para controlar las excepciones y anular la lista de lectores permitidos. La cantidad máxima de elementos es 100. |
owners[] |
Opcional. Es la lista de propietarios del elemento. Este campo no afecta los permisos de acceso al documento. Sin embargo, sí ofrece una clasificación leve que mejora los elementos en los que el usuario que realiza la consulta es propietario. La cantidad máxima de elementos es 5. |
ItemAcl.AclInheritanceType
Tipos de herencia de LCA.
Enumeradores | |
---|---|
NOT_APPLICABLE |
El valor predeterminado cuando este elemento no hereda una LCA. Usa NOT_APPLICABLE cuando inheritAclFrom esté vacío. Un elemento sin herencia de LCA puede tener LCA proporcionadas por sus propios campos readers y deniedReaders . |
CHILD_OVERRIDE |
Durante un conflicto de autorización, la LCA del elemento secundario determina su acceso de lectura. |
PARENT_OVERRIDE |
Durante un conflicto de autorización, la LCA del elemento principal especificado en el campo inheritAclFrom determina el acceso de lectura. |
BOTH_PERMIT |
El acceso se otorga solo si este elemento y el elemento principal especificado en el campo inheritAclFrom permiten el acceso de lectura. |
Principal
Hace referencia a un usuario, grupo o dominio.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión
|
|
gsuitePrincipal |
Esta principal es un usuario, grupo o dominio de Google Workspace. |
userResourceName |
Esta principal es un usuario identificado mediante una identidad externa. El campo de nombre debe especificar el nombre del recurso de usuario con este formato: identitysources/{sourceId}/users/{ID} |
groupResourceName |
Esta principal es un grupo identificado con una identidad externa. El campo de nombre debe especificar el nombre del recurso del grupo con este formato: identitysources/{sourceId}/groups/{ID} |
ItemMetadata
Campos de metadatos disponibles para el elemento.
Representación JSON |
---|
{ "title": string, "sourceRepositoryUrl": string, "containerName": string, "objectType": string, "createTime": string, "updateTime": string, "interactions": [ { object ( |
Campos | |
---|---|
title |
Es el título del artículo. Si se proporciona, será el título que se mostrará del resultado de query.search. La longitud máxima es de 2,048 caracteres. |
sourceRepositoryUrl |
Vínculo al repositorio de código fuente que entrega los datos. Los resultados de la búsqueda aplican este vínculo al título. Los espacios en blanco o los caracteres especiales pueden provocar que los vínculos de resultados de Cloud Seach activen un aviso de redireccionamiento. Para evitar esto, codifica la URL. La longitud máxima es de 2,048 caracteres. |
containerName |
Es el nombre del contenedor de este elemento. La eliminación del elemento contenedor lleva a la eliminación automática de este elemento. Nota: Las LCA no se heredan de un elemento contenedor. Para proporcionar la herencia de LCA para un elemento, usa el campo |
objectType |
Es el tipo de elemento. Debe corresponder al nombre de una definición de objeto en el esquema registrado para la fuente de datos. Por ejemplo, si el esquema de la fuente de datos contiene una definición de objeto con el nombre 'document', las solicitudes de indexación de elementos para objetos de ese tipo deberían establecer objectType como 'document'. La longitud máxima es de 256 caracteres. |
createTime |
La hora en la que se creó el elemento en el repositorio de código fuente. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
updateTime |
La hora en la que se modificó el elemento por última vez en el repositorio de código fuente. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
interactions[] |
Es una lista de interacciones para el elemento. Las interacciones se utilizan para mejorar la calidad de query.search, pero no se exponen a los usuarios finales. La cantidad máxima de elementos es 1,000. |
contentLanguage |
Es el código de idioma según la norma BCP-47 del artículo, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. La longitud máxima es de 32 caracteres. |
mimeType |
El tipo MIME original de |
searchQualityMetadata |
Metadatos adicionales de calidad de búsqueda del elemento |
keywords[] |
Palabras clave o frases adicionales que deberían coincidir con el elemento. Se usa internamente para el contenido generado por usuarios. La cantidad máxima de elementos es 100. La longitud máxima es de 8,192 caracteres. |
hash |
Valor de hash que proporciona el llamador de la API. Esto se puede usar con el método |
contextAttributes[] |
Es un conjunto de atributos con nombre asociados al artículo. Esto se puede usar para influir en la clasificación del elemento según el contexto de la solicitud. La cantidad máxima de elementos es 10. |
Interacción
Representa una interacción entre un usuario y un elemento.
Representación JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
|
principal |
Indica el usuario que realizó una acción en el elemento. |
interactionTime |
Indica la hora en que el usuario realizó una acción en el elemento. Si existen varias acciones del mismo tipo para un solo usuario, solo se registra la acción más reciente. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
Interaction.InteractionType
Tipo de actividad que realizó el usuario en el elemento.
Enumeradores | |
---|---|
UNSPECIFIED |
El valor no es válido. |
VIEW |
Esta interacción indica que el usuario vio el artículo. |
EDIT |
Esta interacción indica que el usuario editó el elemento. |
SearchQualityMetadata
Son los metadatos adicionales de calidad de búsqueda del elemento.
Representación JSON |
---|
{ "quality": number } |
Campos | |
---|---|
quality |
Indica la calidad del elemento, que se utiliza para influir en la calidad de la búsqueda. El valor debe estar entre 0.0 (calidad más baja) y 1.0 (calidad más alta). El valor predeterminado es 0.0. |
ContextAttribute
Es un atributo nombrado asociado a un artículo que se puede usar para influir en la clasificación del artículo según el contexto de la solicitud.
Representación JSON |
---|
{ "name": string, "values": [ string ] } |
Campos | |
---|---|
name |
Es el nombre del atributo. No debe estar vacío. La longitud máxima es de 32 caracteres. El nombre debe comenzar con una letra y solo puede contener letras (de la A a la Z, a-z) o números (0-9). El nombre se normalizará (en minúsculas) antes de que se establezca la coincidencia. |
values[] |
Valores de texto del atributo. La cantidad máxima de elementos es 10. La longitud máxima de un elemento en el array es de 32 caracteres. El valor se normalizará (en minúsculas) antes de que se establezca la coincidencia. |
ItemStructuredData
Campos de datos estructurados disponibles para el elemento.
Representación JSON |
---|
{
"object": {
object ( |
Campos | |
---|---|
object |
Es el objeto de datos estructurados que debe coincidir con una definición de objeto registrada en el esquema de la fuente de datos. |
hash |
Valor de hash que proporciona el llamador de la API. Esto se puede usar con el método |
StructuredDataObject
Un objeto de datos estructurados que consta de propiedades con nombre.
Representación JSON |
---|
{
"properties": [
{
object ( |
Campos | |
---|---|
properties[] |
Las propiedades del objeto. La cantidad máxima de elementos es 1,000. |
NamedProperty
Es un par nombre-valor escrito para datos estructurados. El tipo del valor debe ser el mismo que el tipo registrado para la propiedad name
en la definición del objeto de objectType
.
Representación JSON |
---|
{ "name": string, // Union field |
Campos | |
---|---|
name |
Es el nombre de la propiedad. Este nombre debe corresponder al nombre de la propiedad que se registró para la definición de objeto en el esquema. La longitud máxima permitida para esta propiedad es de 256 caracteres. |
Campo de unión value . Los valores de la propiedad nombrada Ten en cuenta que una propiedad solo puede contener valores de un tipo. Las direcciones (value ) solo pueden ser una de las siguientes opciones: |
|
integerValues |
|
doubleValues |
|
timestampValues |
|
booleanValue |
|
objectValues |
|
enumValues |
|
dateValues |
|
textValues |
|
htmlValues |
|
NamedProperty.IntegerValues
Lista de valores de números enteros.
Representación JSON |
---|
{ "values": [ string ] } |
Campos | |
---|---|
values[] |
|
NamedProperty.DoubleValues
Lista de valores dobles.
Representación JSON |
---|
{ "values": [ number ] } |
Campos | |
---|---|
values[] |
|
NamedProperty.TimestampValues
Lista de valores de marca de tiempo.
Representación JSON |
---|
{ "values": [ string ] } |
Campos | |
---|---|
values[] |
Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
NamedProperty.ObjectValues
Lista de valores de objetos.
Representación JSON |
---|
{
"values": [
{
object ( |
Campos | |
---|---|
values[] |
|
NamedProperty.EnumValues
Lista de valores enum.
Representación JSON |
---|
{ "values": [ string ] } |
Campos | |
---|---|
values[] |
La longitud máxima permitida para los valores de string es de 32 caracteres. |
NamedProperty.DateValues
Lista de valores de fecha.
Representación JSON |
---|
{
"values": [
{
object ( |
Campos | |
---|---|
values[] |
|
NamedProperty.TextValues
Lista de valores de texto.
Representación JSON |
---|
{ "values": [ string ] } |
Campos | |
---|---|
values[] |
La longitud máxima permitida para los valores de texto es de 2,048 caracteres. |
NamedProperty.HtmlValues
Lista de valores HTML.
Representación JSON |
---|
{ "values": [ string ] } |
Campos | |
---|---|
values[] |
La longitud máxima permitida para los valores HTML es de 2,048 caracteres. |
ItemContent
Contenido de un elemento que Cloud Search debe indexar y mostrar. Solo se permiten las strings codificadas en UTF-8 como inlineContent
. Si el contenido se subió y no es binario, debe estar codificado en UTF-8.
Representación JSON |
---|
{ "contentFormat": enum ( |
Campos | |
---|---|
contentFormat |
|
hash |
Información de hash calculada y proporcionada por el cliente de la API para el contenido. Puede usarse con el método items.push para calcular el estado modificado. La longitud máxima es de 2,048 caracteres. |
Campo de unión
|
|
inlineContent |
Contenido que se suministra intercalado en el método de actualización. La longitud máxima es de 102,400 bytes (100 KiB). String codificada en base64. |
contentDataRef |
Sube el ID de referencia de un contenido subido anteriormente a través del método de escritura. |
ItemContent.ContentFormat
Corresponde al formato del contenido. Si el formato es RAW, el contenido debe estar en el formato que especifica mimeType
.
Enumeradores | |
---|---|
UNSPECIFIED |
El valor no es válido. |
HTML |
contentFormat es HTML. |
TEXT |
contentFormat es texto libre. |
RAW |
contentFormat son bytes sin procesar. |
UploadItemRef
Representa una referencia de sesión de carga. Esta referencia se crea con upload method
. Esta referencia es válida durante los 30 días posteriores a su creación. La actualización del contenido del elemento puede referirse al contenido subido a través de contentDataRef
.
Representación JSON |
---|
{ "name": string } |
Campos | |
---|---|
name |
Es el nombre de la referencia del contenido. La longitud máxima es de 2,048 caracteres. |
ItemStatus
Contiene el estado del elemento y los errores.
Representación JSON |
---|
{ "code": enum ( |
Campos | |
---|---|
code |
Código de estado. |
processingErrors[] |
Detalles del error en caso de que el elemento tenga el estado ERROR. |
repositoryErrors[] |
Error del repositorio informado por el conector. |
ProcessingError
Representación JSON |
---|
{ "code": enum ( |
Campos | |
---|---|
code |
Código de error que indica la naturaleza del error |
errorMessage |
Es la descripción del error. |
fieldViolations[] |
En caso de que los campos del elemento no sean válidos, este campo contiene los detalles sobre los errores de validación. |
ProcessingErrorCode
Códigos para indicar el error que encontró el servidor de Cloud Search durante el procesamiento de elementos. Un solo elemento puede contener varios errores de procesamiento.
Enumeradores | |
---|---|
PROCESSING_ERROR_CODE_UNSPECIFIED |
Valor de solo entrada. Usa este valor en Elementos. |
MALFORMED_REQUEST |
La LCA, los metadatos o el contenido del elemento tienen errores de formato o tienen un estado no válido. Fieldleys contiene más detalles sobre dónde se encuentra el problema. |
UNSUPPORTED_CONTENT_FORMAT |
No se admite el formato de recuento. |
INDIRECT_BROKEN_ACL |
Elementos con información de LCA incompleta debido a que se heredaron otros elementos con una LCA dañada o que tienen grupos con subordinados sin asignar. |
ACL_CYCLE |
El gráfico de herencia de LCA formó un ciclo. |
FieldViolation
Representación JSON |
---|
{ "field": string, "description": string } |
Campos | |
---|---|
field |
Ruta del campo con incumplimiento. |
description |
Es la descripción del error. |
RepositoryError
Errores cuando el conector se comunica con el repositorio de código fuente.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
El tipo de error. |
httpStatusCode |
Códigos de error Coincide con la definición de códigos de estado HTTP. |
errorMessage |
Mensaje que describe el error. La longitud máxima permitida del mensaje es de 8,192 caracteres. |
RepositoryError.Type
Lista de códigos de error para problemas de comunicación con el repositorio.
Enumeradores | |
---|---|
UNKNOWN |
Error desconocido. |
NETWORK_ERROR |
Host desconocido o inaccesible |
DNS_ERROR |
Hay un problema de DNS, por ejemplo, el servidor DNS no responde. |
CONNECTION_ERROR |
No se puede conectar al servidor del repositorio. |
AUTHENTICATION_ERROR |
Falló la autenticación debido a credenciales incorrectas. |
AUTHORIZATION_ERROR |
La cuenta de servicio no está autorizada para el repositorio. |
SERVER_ERROR |
Error del servidor del repositorio. |
QUOTA_EXCEEDED |
Se superó la cuota. |
SERVICE_UNAVAILABLE |
El servidor no está disponible temporalmente. |
CLIENT_ERROR |
Error relacionado con el cliente, como una solicitud no válida del conector al servidor del repositorio. |
Item.ItemType
Enumeradores | |
---|---|
UNSPECIFIED |
|
CONTENT_ITEM |
Es un artículo que se indexa con el único fin de entregar información. No se puede hacer referencia a estos elementos en los campos containerName ni inheritAclFrom . |
CONTAINER_ITEM |
Elemento que se indexa y cuyo propósito es proporcionar LCA o contener otros elementos. |
VIRTUAL_CONTAINER_ITEM |
Un elemento que no se indexa, pero que tiene el mismo propósito que CONTAINER_ITEM. |
Métodos |
|
---|---|
|
Borra Item resource para el nombre del recurso especificado. |
|
Borra todos los elementos de una fila. |
|
Obtiene Item resource por nombre del elemento. |
|
Actualiza la LCA, los metadatos y el contenido de Item . |
|
Enumera todos los elementos Item resources o un subconjunto de ellos. |
|
Sondea los elementos no reservados de la cola de indexación y marca un conjunto como reservado, comenzando por los elementos que tienen la marca de tiempo más antigua de la ItemStatus de mayor prioridad. |
|
Envía un elemento a una cola para sondearlo y actualizarlo más tarde. |
|
Anula la reserva de todos los elementos de una fila, lo que hace que todos sean aptos para encuestar. |
|
Crea una sesión de carga para subir contenido del elemento. |