- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- IndexItemOptions
- Wypróbuj
Zaktualizuje Item
listę kontroli dostępu, metadane i treści. Jeśli nie istnieje, zostanie wstawiona kolumna Item
. Ta metoda nie obsługuje częściowych aktualizacji. Pola bez podanych wartości są usuwane z indeksu wyszukiwarki w chmurze.
Do wykonania tej operacji wymagane jest konto administratora lub konto usługi. Używane konto usługi to to, które znajduje się na białej liście w odpowiednim źródle danych.
Żądanie HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
item.name |
Nazwa produktu. Format: datasources/{sourceId}/items/{itemId} To pole jest wymagane. Maksymalna długość to 1536 znaków. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
Pola | |
---|---|
item.acl |
Lista kontroli dostępu do tego elementu. |
item.metadata |
informacje metadanych. |
item.structuredData |
Uporządkowane dane dotyczące produktu, które powinny być zgodne ze zdefiniowaną definicją obiektu w schemacie źródła danych. |
item.content |
Treści elementów, które mają zostać zindeksowane i udostępnione do wyszukiwania. |
item.version |
Wymagane. System indeksowania przechowuje wersję z źródła danych jako ciąg bajtów i porównuje wersję produktu w indeksie z wersją produktu w kolejce za pomocą sortowania leksykalnego. Wyszukiwanie w chmurze nie indeksuje ani nie usuwa żadnych elementów w kolejce o wartości wersji mniejszej lub równej wersji obecnie indeksowanego elementu. Maksymalna długość tego pola to 1024 bajty. Informacje o tym, jak wersja elementu wpływa na proces usuwania, znajdziesz w artykule Zarządzanie wersjami po ręcznym usunięciu. Ciąg znaków zakodowany w formacie Base64. |
item.status |
Stan produktu. Pole tylko z danymi wyjściowymi. |
item.queue |
kolejka, do której należy ten element. Maksymalna długość to 100 znaków. |
item.payload |
Dodatkowy stan, który może przechowywać łącznik. Maksymalna długość to 10 tys. bajtów. Ciąg znaków zakodowany w formacie Base64. |
item.itemType |
Typ tego elementu. |
connectorName |
Nazwa oprogramowania sprzęgającego wykonującego to wywołanie. Format: datasources/{sourceId}/connectors/{ID} |
mode |
Wymagane. Tryb żądania. |
debugOptions |
Typowe opcje debugowania. |
indexItemOptions |
|
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
IndexItemOptions
Zapis JSON |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
Pola | |
---|---|
allowUnknownGsuitePrincipals |
Określa, czy żądanie indeksowania powinno zezwalać podmiotom Google Workspace, które nie istnieją lub zostały usunięte. |