- HTTP-запрос
 - Параметры пути
 - Тело запроса
 - Тело ответа
 - Области авторизации
 - Индекситемварианты
 - Попробуйте!
 
 Обновляет список управления доступом к Item , метаданные и содержимое. Он вставит Item , если он не существует. Этот метод не поддерживает частичные обновления. Поля, в которых не указаны значения, удаляются из индекса Cloud Search.
Для выполнения этого API требуется учетная запись администратора или службы. Используемая учетная запись службы находится в белом списке соответствующего источника данных.
HTTP-запрос
 POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры | |
|---|---|
 item.name |   Название предмета. Формат: источники данных/{sourceId}/items/{itemId} Это обязательное поле. Максимальная длина — 1536 символов.  | 
Тело запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление | 
|---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum (  | 
| Поля | |
|---|---|
 item.acl |   Список контроля доступа для этого элемента.  | 
 item.metadata |   Информация метаданных.  | 
 item.structuredData |   Структурированные данные для элемента, которые должны соответствовать зарегистрированному определению объекта в схеме источника данных.  | 
 item.content |   Содержимое элемента, которое необходимо проиндексировать и сделать доступным для поиска по тексту.  | 
 item.version |   Необходимый. Система индексирования сохраняет версию из источника данных в виде байтовой строки и сравнивает версию элемента в индексе с версией объекта в очереди, используя лексическое упорядочение. Индексирование Cloud Search не будет индексировать или удалять элементы в очереди, значение версии которых меньше или равно версии текущего индексируемого элемента. Максимальная длина этого поля составляет 1024 байта. Информацию о том, как версия элемента влияет на процесс удаления, см. в разделе Обработка редакций после удаления вручную . Строка в кодировке Base64.  | 
 item.status |   статус предмета. Поле только для вывода.  | 
 item.queue |   Очередь, к которой принадлежит этот элемент. Максимальная длина — 100 символов.  | 
 item.payload |   Для этого элемента может храниться дополнительный коннектор состояния. Максимальная длина — 10000 байт. Строка в кодировке Base64.  | 
 item.itemType |   Тип этого элемента.  | 
 connectorName |   Имя соединителя, выполняющего этот вызов. Формат: источники данных/{sourceId}/connectors/{id}  | 
 mode |   Необходимый. RequestMode для этого запроса.  | 
 debugOptions |   Общие параметры отладки.  | 
 indexItemOptions |    | 
Тело ответа
 В случае успеха тело ответа содержит экземпляр Operation . 
Области авторизации
Требуется одна из следующих областей OAuth:
-  
https://www.googleapis.com/auth/cloud_search.indexing -  
https://www.googleapis.com/auth/cloud_search 
Дополнительную информацию см. в руководстве по авторизации .
Индекситемварианты
| JSON-представление | 
|---|
{ "allowUnknownGsuitePrincipals": boolean }  | 
| Поля | |
|---|---|
 allowUnknownGsuitePrincipals |   Указывает, должен ли запрос индекса разрешать несуществующие или удаленные субъекты Google Workspace.  |