Aktualizuje źródło danych.
Uwaga: do uruchomienia tego interfejsu API wymagane jest konto administratora.
Żądanie HTTP
PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
source.name |
Nazwa zasobu źródła danych. Format: źródła danych/{sourceId}. Nazwa jest ignorowana podczas tworzenia źródła danych. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "source": { "name": string, "displayName": string, "shortName": string, "indexingServiceAccounts": [ string ], "disableServing": boolean, "disableModifications": boolean, "itemsVisibility": [ { // Union field |
Pola | |
---|---|
source.displayName |
To pole jest wymagane. Wyświetlana nazwa źródła danych Maksymalna długość to 300 znaków. |
source.shortName |
Krótka nazwa lub alias źródła. Będzie ona używana do dopasowania operatora „source”. Jeśli np. krótka nazwa to <value>, zapytanie typu source:<wartość> zwróci wyniki tylko dla tego źródła. Wartość musi być niepowtarzalna wśród wszystkich źródeł danych. Wartość może zawierać tylko znaki alfanumeryczne (a–zA–Z0–9). Wartość nie może zaczynać się od „google” i nie może być jednym z tych elementów: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, team. Jego maksymalna długość to 32 znaki. |
source.indexingServiceAccounts[] |
Lista kont usługi, które mają dostęp do indeksowania. |
source.disableServing |
Wyłącz wyświetlanie jakichkolwiek wyników wyszukiwania lub wspomaganych. |
source.disableModifications |
Jeśli ma wartość prawda, ustawia źródło danych w tryb tylko do odczytu. W trybie „tylko do odczytu” interfejs Indexing API odrzuca wszystkie żądania indeksowania i usuwania elementów w tym źródle. Włączenie trybu tylko do odczytu nie zatrzymuje przetwarzania zaakceptowanych wcześniej danych. |
source.itemsVisibility[] |
To pole ogranicza widoczność do elementów na poziomie źródła danych. Elementy w źródle danych są ograniczone do sumy użytkowników i grup uwzględnionych w tym polu. Pamiętaj, że nie gwarantuje to dostępu do konkretnego elementu, ponieważ użytkownicy muszą mieć uprawnienia listy kontroli dostępu do elementów składowych. Zapewnia to wysoki poziom dostępu do całego źródła danych i zapobiega udostępnianiu poszczególnych elementów poza tą widocznością. |
source.returnThumbnailUrls |
Może prosić użytkownika o pobranie identyfikatora URI miniatury dla elementów zindeksowanych w tym źródle danych. |
source.operationIds[] |
Identyfikatory długo trwających operacji (LRO) uruchomionych obecnie dla tego schematu. |
debugOptions |
Typowe opcje debugowania. |
updateMask |
Dotyczy tylko Zaktualizuj maskę, aby kontrolować pola do aktualizacji. Przykładowe ścieżki pól:
|
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.settings.indexing
https://www.googleapis.com/auth/cloud_search.settings
https://www.googleapis.com/auth/cloud_search
Więcej informacji znajdziesz w przewodniku po autoryzacji.