Cập nhật một nguồn dữ liệu.
Lưu ý: API này yêu cầu tài khoản quản trị viên để thực thi.
Yêu cầu HTTP
PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
source.name |
Tên của tài nguyên nguồn dữ liệu. Định dạng: datasources/{sourceId}. Tên này sẽ bị bỏ qua khi tạo nguồn dữ liệu. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "source": { "name": string, "displayName": string, "shortName": string, "indexingServiceAccounts": [ string ], "disableServing": boolean, "disableModifications": boolean, "itemsVisibility": [ { // Union field |
Các trường | |
---|---|
source.displayName |
Bắt buộc. Tên hiển thị của nguồn dữ liệu Độ dài tối đa là 300 ký tự. |
source.shortName |
Tên ngắn hoặc biệt hiệu của nguồn. Giá trị này sẽ được dùng để khớp với toán tử "source". Ví dụ: nếu tên rút gọn là <value> thì các truy vấn như source:<value> sẽ chỉ trả về kết quả cho nguồn này. Giá trị này phải là duy nhất trên tất cả các nguồn dữ liệu. Giá trị chỉ được chứa ký tự chữ-số (a-zA-Z0-9). Giá trị không được bắt đầu bằng "google" và không được là một trong các giá trị sau: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, mọi người, nhóm. Độ dài tối đa của nhãn là 32 ký tự. |
source.indexingServiceAccounts[] |
Danh sách tài khoản dịch vụ có quyền truy cập lập chỉ mục. |
source.disableServing |
Tắt tính năng cung cấp mọi kết quả tìm kiếm hoặc hỗ trợ. |
source.disableModifications |
Nếu đúng, hãy đặt nguồn dữ liệu ở chế độ chỉ có thể đọc. Ở chế độ chỉ có thể đọc, API lập chỉ mục sẽ từ chối mọi yêu cầu lập chỉ mục hoặc xoá các mục trong nguồn này. Việc bật chế độ chỉ đọc sẽ không dừng quá trình xử lý dữ liệu đã được chấp nhận trước đó. |
source.itemsVisibility[] |
Trường này hạn chế chế độ hiển thị đối với các mục ở cấp nguồn dữ liệu. Các mục trong nguồn dữ liệu này chỉ dành cho nhóm người dùng và nhóm có trong trường này. Lưu ý rằng việc này không đảm bảo quyền truy cập vào mục cụ thể vì người dùng cần có quyền ACL đối với các mục được chứa. Điều này đảm bảo quyền truy cập cấp cao trên toàn bộ nguồn dữ liệu và các mục riêng lẻ không được chia sẻ bên ngoài chế độ hiển thị này. |
source.returnThumbnailUrls |
Người dùng có thể yêu cầu lấy URI hình thu nhỏ cho các Mục được lập chỉ mục trong nguồn dữ liệu này không. |
source.operationIds[] |
Mã nhận dạng của các hoạt động lâu dài (LRO) hiện đang chạy cho giản đồ này. |
debugOptions |
Các tuỳ chọn gỡ lỗi phổ biến. |
updateMask |
Chỉ áp dụng cho Cập nhật mặt nạ để kiểm soát những trường cần cập nhật. Ví dụ về đường dẫn trường:
|
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation
.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/cloud_search.settings.indexing
https://www.googleapis.com/auth/cloud_search.settings
https://www.googleapis.com/auth/cloud_search
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.