- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- Essayer
Met à jour une source de données.
Remarque:L'exécution de cette API nécessite un compte administrateur.
Requête HTTP
PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
source.name |
Nom de la ressource de source de données. Format: datasources/{sourceId}. Le nom est ignoré lors de la création d'une source de données. |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "source": { "name": string, "displayName": string, "shortName": string, "indexingServiceAccounts": [ string ], "disableServing": boolean, "disableModifications": boolean, "itemsVisibility": [ { // Union field |
Champs | |
---|---|
source.displayName |
Obligatoire. Nom à afficher de la source de données. Il ne doit pas dépasser 300 caractères. |
source.shortName |
Nom court ou alias de la source. Cette valeur sera utilisée pour établir une correspondance avec l'opérateur "source". Par exemple, si le nom court est <value>, les requêtes telles que <value> ne renverront que les résultats de cette source. La valeur doit être unique parmi toutes les sources de données. La valeur ne doit contenir que des caractères alphanumériques (a-zA-Z0-9). La valeur ne peut pas commencer par "google" et ne peut pas être l'une des suivantes: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, Teams. Il ne doit pas dépasser 32 caractères. |
source.indexingServiceAccounts[] |
Liste des comptes de service ayant accès à l'indexation. |
source.disableServing |
Désactivez l'affichage des résultats de recherche et des clics indirects. |
source.disableModifications |
Si la valeur est "true", la source de données passe en mode lecture seule. En mode lecture seule, l'API d'indexation rejette toute requête d'indexation ou de suppression d'éléments dans cette source. L'activation du mode lecture seule n'interrompt pas le traitement des données précédemment acceptées. |
source.itemsVisibility[] |
Ce champ limite la visibilité aux éléments au niveau de la source de données. Les éléments de la source de données sont limités à l'union des utilisateurs et des groupes inclus dans ce champ. Notez que cela ne garantit pas l'accès à un élément spécifique, car les utilisateurs doivent disposer d'autorisations LCA sur les éléments contenus. Cela garantit un accès de haut niveau à l'ensemble de la source de données et que les éléments individuels ne sont pas partagés en dehors de cette visibilité. |
source.returnThumbnailUrls |
Un utilisateur peut-il demander à obtenir l'URI de la vignette des éléments indexés dans cette source de données ? |
source.operationIds[] |
ID des opérations de longue durée en cours d'exécution pour ce schéma. |
debugOptions |
Options de débogage courantes |
updateMask |
S'applique uniquement à Mettez à jour le masque pour contrôler les champs à mettre à jour. Exemples de chemins d'accès aux champs:
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de Operation
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/cloud_search.settings.indexing
https://www.googleapis.com/auth/cloud_search.settings
https://www.googleapis.com/auth/cloud_search
Pour en savoir plus, consultez le guide relatif aux autorisations.