데이터 소스를 업데이트합니다.
참고: 이 API를 실행하려면 관리자 계정이 필요합니다.
HTTP 요청
PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
source.name |
데이터 소스 리소스의 이름입니다. 형식: datasources/{sourceId}. 이 이름은 데이터 소스를 만들 때 무시됩니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "source": { "name": string, "displayName": string, "shortName": string, "indexingServiceAccounts": [ string ], "disableServing": boolean, "disableModifications": boolean, "itemsVisibility": [ { // Union field |
필드 | |
---|---|
source.displayName |
필수 항목입니다. 데이터 소스의 표시 이름입니다. 최대 길이는 300자(영문 기준)입니다. |
source.shortName |
소스의 닉네임 또는 별칭. 이 값은 'source' 연산자와 일치하는 항목을 찾는 데 사용됩니다. 예를 들어 짧은 이름이 <value>인 경우 source:<value>와 같은 쿼리는 이 소스에 대한 결과만 반환합니다. 값은 모든 데이터 소스에서 고유해야 합니다. 값은 영숫자 문자 (a~zA~Z0~9)만 포함해야 합니다. 값은 'google'로 시작할 수 없으며 mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, team 중 하나가 될 수 없습니다. 최대 길이는 32자(영문 기준)입니다. |
source.indexingServiceAccounts[] |
색인 생성 액세스 권한이 있는 서비스 계정 목록입니다. |
source.disableServing |
검색 또는 지원 결과 게재를 중지합니다. |
source.disableModifications |
true인 경우 데이터 소스를 읽기 전용 모드로 설정합니다. 읽기 전용 모드에서 Indexing API는 이 소스의 항목에 대한 색인 생성 또는 삭제 요청을 거부합니다. 읽기 전용 모드를 사용 설정해도 이전에 허용된 데이터의 처리는 중단되지 않습니다. |
source.itemsVisibility[] |
이 필드는 데이터 소스 수준의 항목에 대한 공개 상태를 제한합니다. 데이터 소스 내의 항목은 이 필드에 포함된 사용자 및 그룹의 합집합으로 제한됩니다. 사용자에게 포함된 항목에 대한 ACL 권한이 있어야 하므로 이렇게 해도 특정 항목에 대한 액세스가 보장되는 것은 아닙니다. 이렇게 하면 전체 데이터 소스에 대한 높은 수준의 액세스가 보장되며 개별 항목이 이 공개 상태 외부에서 공유되지 않습니다. |
source.returnThumbnailUrls |
사용자가 이 데이터 소스에서 색인이 생성된 항목의 썸네일 URI를 가져오도록 요청할 수 있나요? |
source.operationIds[] |
현재 이 스키마에서 실행 중인 장기 실행 작업 (LRO)의 ID입니다. |
debugOptions |
일반 디버그 옵션 |
updateMask |
업데이트할 필드를 제어하기 위해 마스크를 업데이트합니다. 필드 경로 예시:
|
응답 본문
성공한 경우 응답 본문에 Operation
의 인스턴스가 포함됩니다.
승인 범위
다음 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
자세한 내용은 승인 가이드를 참고하세요.