Method: settings.datasources.update

Bir veri kaynağını günceller.

Not: Bu API'nin yürütülebilmesi için 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: veri kaynakları/{kaynak kimliği}.

Veri kaynağı oluşturulurken bu ad yoksayılır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler 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

Kaynak için kısa ad veya takma ad. Bu değer, "source" operatörüyle eşleştirmek için kullanılır. Örneğin, kısa ad <value> ise <value> gibi sorgular yalnızca bu kaynakla ilgili 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. Maksimum uzunluk 32 karakterdir.
source.indexingServiceAccounts[]

string

Dizine ekleme erişimine sahip hizmet hesaplarının listesi.
source.disableServing

boolean

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

boolean

True (doğru) değerine ayarlanırsa veri kaynağını salt okuma moduna ayarlar. Salt okuma modunda, Dizine Ekleme API'si, 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 birleşimiyle sınırlıdır. Kullanıcıların içerilen öğelerde EKL izinlerine sahip olması gerektiğinden, bunun belirli bir öğeye erişim sağlamayacağını unutmayın. Bu, tüm veri kaynağına üst düzey erişim sağlar ve tek tek öğeler 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 şu anda çalışan Uzun Süreli İşlemlerin (LRO'lar) kimlikleri.
debugOptions

object (DebugOptions)

Yaygın 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 içinde belirtilen alanlar güncellenir.
  • updateMask içinde bir alan belirtir, ancak kaynakta bu alanın değerini belirtmezseniz bu alan temizlenir.
  • updateMask mevcut değilse, boşsa veya * 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ılavuzuna göz atın.