Method: indexing.datasources.items.index

Atualiza a ACL, os metadados e o conteúdo de Item. Ele vai inserir Item se ele não existir. Esse método não é compatível com atualizações parciais. Os campos sem valores fornecidos são limpos no índice do Cloud Search.

Essa API exige uma conta de administrador ou de serviço para ser executada. A conta de serviço usada é a que está na lista de permissões da fonte de dados correspondente.

Solicitação HTTP

POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
item.name

string

O nome do item. Formato: datasources/{sourceId}/items/{itemId}

Este campo é obrigatório. O tamanho máximo é de 1.536 caracteres.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "item": {
    "name": string,
    "acl": {
      "inheritAclFrom": string,
      "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
      "readers": [
        {
          object (Principal)
        }
      ],
      "deniedReaders": [
        {
          object (Principal)
        }
      ],
      "owners": [
        {
          object (Principal)
        }
      ]
    },
    "metadata": {
      "title": string,
      "sourceRepositoryUrl": string,
      "containerName": string,
      "objectType": string,
      "createTime": string,
      "updateTime": string,
      "interactions": [
        {
          object (Interaction)
        }
      ],
      "contentLanguage": string,
      "mimeType": string,
      "searchQualityMetadata": {
        object (SearchQualityMetadata)
      },
      "keywords": [
        string
      ],
      "hash": string,
      "contextAttributes": [
        {
          object (ContextAttribute)
        }
      ]
    },
    "structuredData": {
      "object": {
        object (StructuredDataObject)
      },
      "hash": string
    },
    "content": {
      "contentFormat": enum (ItemContent.ContentFormat),
      "hash": string,

      // Union field content can be only one of the following:
      "inlineContent": string,
      "contentDataRef": {
        object (UploadItemRef)
      }
      // End of list of possible types for union field content.
    },
    "version": string,
    "status": {
      "code": enum (ItemStatus.Code),
      "processingErrors": [
        {
          object (ProcessingError)
        }
      ],
      "repositoryErrors": [
        {
          object (RepositoryError)
        }
      ]
    },
    "queue": string,
    "payload": string,
    "itemType": enum (Item.ItemType)
  },
  "connectorName": string,
  "mode": enum (RequestMode.Mode),
  "debugOptions": {
    object (DebugOptions)
  },
  "indexItemOptions": {
    object (IndexItemOptions)
  }
}
Campos
item.acl

object (ItemAcl)

Lista de controle de acesso para este item.
item.metadata

object (ItemMetadata)

As informações de metadados.
item.structuredData

object (ItemStructuredData)

Os dados estruturados do item que precisam estar em conformidade com uma definição de objeto registrada no esquema da fonte de dados.
item.content

object (ItemContent)

Conteúdo do item a ser indexado e pesquisável.
item.version

string (bytes format)

Obrigatório. O sistema de indexação armazena a versão da origem de dados como uma string de bytes e compara a versão do item no índice com a versão do item na fila usando a ordem lexical.

A indexação do Cloud Search não vai indexar nem excluir nenhum item na fila com um valor de versão menor ou igual ao do item indexado. O comprimento máximo para esse campo é de 1.024 bytes.

Para saber como a versão do item afeta o processo de exclusão, consulte Processar revisões após exclusões manuais.

Uma string codificada em base64.
item.status

object (ItemStatus)

Status do item. Campo somente de saída.
item.queue

string

Fila a que o item pertence. O comprimento máximo é de 100 caracteres.
item.payload

string (bytes format)

O conector de estado adicional pode armazenar para este item. O comprimento máximo é de 10.000 bytes.

Uma string codificada em base64.
item.itemType

enum (Item.ItemType)

O tipo do item.
connectorName

string

O nome do conector que faz essa chamada.

Formato: datasources/{sourceId}/connectors/{ID}
mode

enum (RequestMode.Mode)

Obrigatório. O RequestMode para essa solicitação.
debugOptions

object (DebugOptions)

Opções de depuração comuns.
indexItemOptions

object (IndexItemOptions)

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

Para mais informações, consulte o guia de autorização.

IndexItemOptions

Representação JSON 
{
  "allowUnknownGsuitePrincipals": boolean
}
Campos
allowUnknownGsuitePrincipals

boolean

Especifica se a solicitação de índice precisa permitir principais do Google Workspace que não existem ou foram excluídos.