Method: settings.datasources.update

Bir veri kaynağını günceller.

Not: Bu API'nin yürütülebilmesi için bir yönetici hesabı gerekir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
source.name

string

Veri kaynağı kaynağının adı. Biçim: datasources/{sourceId}.

Bu ad, veri kaynağı oluşturulurken yoksayılır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "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
}
Alanlar
source.displayName

string

Zorunlu. Veri kaynağının görünen adı Maksimum uzunluk 300 karakterdir.
source.shortName

string

Kaynağın kısa adı veya takma adı. Bu değer, "kaynak" ile eşleştirmek için kullanılır operatörümüzü kullanabilirsiniz. Örneğin, kısa ad <value> ise <value> gibi sorgular yalnızca bu kaynağa ait sonuçları döndürür. Değer, tüm veri kaynakları genelinde benzersiz olmalıdır. Değer yalnızca alfanümerik karakterler (a-zA-Z0-9) içermelidir. Değer "google" ile başlayamaz ve şunlardan biri olamaz: mail, gmail, docs, drive, groups, sites, calendar, hangouts, gplus, keep, people, Teams. En fazla 32 karakter uzunluğunda olabilir.
source.indexingServiceAccounts[]

string

Dizine ekleme erişimi olan hizmet hesaplarının listesi.
source.disableServing

boolean

Tüm arama veya yardım sonuçlarını sunmayı devre dışı bırakın.
source.disableModifications

boolean

Doğru değerine ayarlanırsa veri kaynağını salt okuma moduna ayarlar. Dizine Ekleme API'si salt okuma modunda bu kaynaktaki öğeleri dizine ekleme veya silme isteklerini reddeder. Salt okuma modunun etkinleştirilmesi, daha önce kabul edilen verilerin işlenmesini durdurmaz.
source.itemsVisibility[]

object (GSuitePrincipal)

Bu alan, görünürlüğü veri kaynağı düzeyindeki öğelerle kısıtlar. Veri kaynağındaki öğeler, bu alanda yer alan kullanıcıların ve grupların birliğiyle sınırlıdır. Kullanıcıların içerilen öğelerde EKL izinlerine sahip olması gerektiğinden, bu işlemin belirli bir öğeye erişimi garanti etmediğini unutmayın. Bu, veri kaynağının tamamına üst düzey erişim sağlar ve bağımsız öğelerin bu görünürlüğün dışında paylaşılmaz.
source.returnThumbnailUrls

boolean

Kullanıcı, bu veri kaynağında dizine eklenen öğeler için küçük resim URI'si alma isteğinde bulunabilir.
source.operationIds[]

string

Bu şema için çalışan Uzun Süreli İşlemlerin (LRO'lar) kimlikleri.
debugOptions

object (DebugOptions)

Sık karşılaşılan hata ayıklama seçenekleri.
updateMask

string (FieldMask format)

Yalnızca settings.datasources.patch için geçerlidir.

Hangi alanların güncelleneceğini kontrol etmek için maskeyi güncelleyin. Örnek alan yolları: name, displayName.

  • updateMask boş değilse yalnızca updateMask özelliğinde belirtilen alanlar güncellenir.
  • updateMask içinde bir alan belirtir ancak kaynakta değerini belirtmezseniz bu alan temizlenir.
  • updateMask yoksa veya boşsa ya da * değerine sahipse tüm alanlar güncellenir.

Yanıt gövdesi

Başarılıysa yanıt metni, Operation öğesinin bir örneğini içerir.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.