- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Atualiza uma fonte de dados.
Observação:essa API exige uma conta de administrador para ser executada.
Solicitação HTTP
PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
source.name |
O nome do recurso da fonte de dados. Formato: fontes de dados/{sourceId}. Esse nome é ignorado na criação da fonte de dados. |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "source": { "name": string, "displayName": string, "shortName": string, "indexingServiceAccounts": [ string ], "disableServing": boolean, "disableModifications": boolean, "itemsVisibility": [ { // Union field |
Campos | |
---|---|
source.displayName |
Obrigatório. Nome de exibição da fonte de dados. O tamanho máximo é de 300 caracteres. |
source.shortName |
Um nome curto ou alias para a fonte. Esse valor será usado para corresponder à "origem" usando um operador lógico. Por exemplo, se o nome curto for <value>, consultas como <value> só retornarão resultados para essa origem. O valor precisa ser exclusivo em todas as fontes de dados. O valor precisa conter apenas caracteres alfanuméricos (a-zA-Z0-9). O valor não pode começar com "google". e não pode ser um destes: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people e times. O tamanho máximo é de 32 caracteres. |
source.indexingServiceAccounts[] |
Lista de contas de serviço com acesso de indexação. |
source.disableServing |
Desativa a veiculação de resultados de pesquisa ou assistência. |
source.disableModifications |
Se verdadeiro, define a fonte de dados para o modo somente leitura. No modo somente leitura, a API Indexing rejeita todas as solicitações para indexar ou excluir itens nessa origem. Ativar o modo somente leitura não interrompe o processamento dos dados aceitos anteriormente. |
source.itemsVisibility[] |
Esse campo restringe a visibilidade de itens no nível da fonte de dados. Os itens da fonte de dados são restritos à união de usuários e grupos incluídos nesse campo. Isso não garante o acesso a um item específico, pois os usuários precisam ter permissões de ACL nos itens contidos. Isso garante acesso de alto nível a toda a fonte de dados e que os itens individuais não sejam compartilhados fora dessa visibilidade. |
source.returnThumbnailUrls |
Um usuário pode solicitar a URI de miniatura para itens indexados nessa fonte de dados. |
source.operationIds[] |
IDs das operações de longa duração (LROs, na sigla em inglês) atualmente em execução para este esquema. |
debugOptions |
Opções comuns de depuração. |
updateMask |
Aplicável apenas ao Máscara de atualização para controlar quais campos atualizar. Exemplos de caminhos de campo:
|
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.settings.indexing
https://www.googleapis.com/auth/cloud_search.settings
https://www.googleapis.com/auth/cloud_search
Para mais informações, consulte o Guia de autorização.