Method: settings.datasources.update

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

string

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 gsuite_principal can be only one of the following:
        "gsuiteUserEmail": string,
        "gsuiteGroupEmail": string,
        "gsuiteDomain": boolean
        // End of list of possible types for union field gsuite_principal.
      }
    ],
    "returnThumbnailUrls": boolean,
    "operationIds": [
      string
    ]
  },
  "debugOptions": {
    object (DebugOptions)
  },
  "updateMask": string
}
Các trường
source.displayName

string

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

string

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[]

string

Danh sách tài khoản dịch vụ có quyền truy cập lập chỉ mục.
source.disableServing

boolean

Tắt tính năng cung cấp mọi kết quả tìm kiếm hoặc hỗ trợ.
source.disableModifications

boolean

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[]

object (GSuitePrincipal)

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

boolean

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[]

string

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

object (DebugOptions)

Các tuỳ chọn gỡ lỗi phổ biến.
updateMask

string (FieldMask format)

Chỉ áp dụng cho settings.datasources.patch.

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: name, displayName.

  • Nếu updateMask không trống thì chỉ các trường được chỉ định trong updateMask mới được cập nhật.
  • Nếu bạn chỉ định một trường trong updateMask, nhưng không chỉ định giá trị của trường đó trong nguồn, thì trường đó sẽ bị xoá.
  • Nếu updateMask không có hoặc bị trống hoặc có giá trị * thì tất cả các trường đều được cập nhật.

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.