Method: settings.datasources.update

Memperbarui sumber data.

Catatan: API ini memerlukan akun admin agar dapat dijalankan.

Permintaan HTTP

PUT https://cloudsearch.googleapis.com/v1/settings/{source.name=datasources/*}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
source.name

string

Nama resource sumber data. Format: sumber data/{sourceId}.

Nama ini diabaikan saat membuat sumber data.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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
}
Kolom
source.displayName

string

Wajib diisi. Nama tampilan sumber data Panjang maksimum adalah 300 karakter.

source.shortName

string

Nama pendek atau alias untuk sumber. Nilai ini akan digunakan untuk mencocokkan dengan 'sumber' operator. Misalnya, jika nama pendeknya adalah <value>, kueri seperti <value> hanya akan menampilkan hasil untuk sumber ini. Nilainya harus unik di semua sumber data. Nilai hanya boleh berisi karakter alfanumerik (a-zA-Z0-9). Nilai tidak boleh diawali dengan 'google' dan tidak boleh berupa salah satu dari hal berikut: email, gmail, dokumen, drive, grup, situs, kalender, hangouts, gplus, keep, orang, tim. Panjang maksimumnya adalah 32 karakter.

source.indexingServiceAccounts[]

string

Daftar akun layanan yang memiliki akses pengindeksan.

source.disableServing

boolean

Nonaktifkan penayangan hasil penelusuran atau bantuan apa pun.

source.disableModifications

boolean

Jika true (benar), menetapkan sumber data ke mode hanya baca. Dalam mode hanya baca, Indexing API menolak permintaan apa pun untuk mengindeks atau menghapus item dalam sumber ini. Mengaktifkan mode hanya-baca tidak menghentikan pemrosesan data yang telah diterima sebelumnya.

source.itemsVisibility[]

object (GSuitePrincipal)

Kolom ini membatasi visibilitas untuk item di tingkat sumber data. Item dalam sumber data dibatasi untuk gabungan pengguna dan grup yang disertakan dalam kolom ini. Perhatikan bahwa, hal ini tidak memastikan akses ke item tertentu, karena pengguna harus memiliki izin ACL pada item yang dimuat. Tindakan ini akan memastikan akses tingkat tinggi ke seluruh sumber data, dan bahwa item individual tidak dibagikan di luar visibilitas ini.

source.returnThumbnailUrls

boolean

Dapatkah pengguna meminta untuk mendapatkan URI thumbnail untuk Item yang diindeks dalam sumber data ini.

source.operationIds[]

string

ID Operasi yang Berjalan Lama (LLO) yang saat ini berjalan untuk skema ini.

debugOptions

object (DebugOptions)

Opsi debug umum.

updateMask

string (FieldMask format)

Hanya berlaku untuk settings.datasources.patch.

Perbarui mask untuk mengontrol kolom mana yang akan diperbarui. Contoh jalur kolom: name, displayName.

  • Jika updateMask tidak kosong, hanya kolom yang ditentukan dalam updateMask yang akan diperbarui.
  • Jika Anda menentukan kolom di updateMask, tetapi tidak menentukan nilainya di sumber, kolom tersebut akan dihapus.
  • Jika updateMask tidak ada atau kosong atau memiliki nilai *, semua kolom akan diperbarui.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud_search.settings.indexing
  • https://www.googleapis.com/auth/cloud_search.settings
  • https://www.googleapis.com/auth/cloud_search

Untuk informasi selengkapnya, lihat Panduan otorisasi.