REST Resource: indexing.datasources.items

{
  "name": string,
  "acl": {
    object (ItemAcl)
  },
  "metadata": {
    object (ItemMetadata)
  },
  "structuredData": {
    object (ItemStructuredData)
  },
  "content": {
    object (ItemContent)
  },
  "version": string,
  "status": {
    object (ItemStatus)
  },
  "queue": string,
  "payload": string,
  "itemType": enum (Item.ItemType)
}

string

Öğenin adı. Biçim: datasources/{sourceId}/items/{itemId}

Bu alanının doldurulması zorunludur. En çok 1536 karakter kullanılabilir.

object (ItemAcl)

Bu öğe için erişim kontrol listesi.

object (ItemMetadata)

Meta veri bilgileri.

object (ItemStructuredData)

Veri kaynağının şemasında kayıtlı nesne tanımına uyması gereken öğenin yapılandırılmış verileri.

object (ItemContent)

Dizine eklenecek ve metin aranabilir hale getirilecek öğe içeriği.

string (bytes format)

Zorunlu. Dizine ekleme sistemi, veri kaynağındaki sürümü bir bayt dizesi olarak depolar ve dizindeki Öğe sürümünü, sözlükteki sıralamayı kullanarak sıraya alınan Öğenin sürümüyle karşılaştırır.

Cloud Search Dizine Ekleme, sıraya alınmış ve hâlihazırda dizine eklenmiş öğenin sürümünden daha düşük veya bu sürüme eşit olan bir sürüm değerine sahip öğeleri dizine eklemez ya da silmez. Bu alan için maksimum uzunluk 1.024 bayttır.

Öğe sürümünün silme işlemini nasıl etkilediği hakkında bilgi edinmek için Manuel silme işleminden sonra düzeltmeleri işleme başlıklı makaleyi inceleyin.

base64 kodlu bir dize.

object (ItemStatus)

Öğenin durumu. Yalnızca çıkış alanı.

string

Bu öğenin ait olduğu sıraya ekleyin. En çok 100 karakter kullanılabilir.

string (bytes format)

Bu öğe için ek durum bağlayıcısı depolayabilir. Maksimum uzunluk 10.000 bayttır.

base64 kodlu bir dize.

enum (Item.ItemType)

Bu öğenin türü.

{
  "inheritAclFrom": string,
  "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
  "readers": [
    {
      object (Principal)
    }
  ],
  "deniedReaders": [
    {
      object (Principal)
    }
  ],
  "owners": [
    {
      object (Principal)
    }
  ]
}

string

Erişim İzni Listesi'ni (EKL) devralacak öğenin adı. Not: EKL devralma yalnızca alt öğelere erişim izinleri sağlar ve yapısal ilişkileri tanımlamaz veya büyük öğe gruplarını silmek için kullanışlı yollar sunmaz. Dizinden bir EKL üst öğesi silindiğinde, yalnızca inheritAclFrom alanında üst öğeye referans veren alt öğelerin erişim izinleri değişir. Öğe dizinde hâlâ mevcuttur, ancak arama sonuçlarında görünmeyebilir. Buna karşılık, bir kapsayıcı öğesi silindiğinde containerName alanı aracılığıyla kapsayıcıya referans veren tüm öğeler de silinir. Bu alan için maksimum uzunluk 1536 karakterdir.

enum (ItemAcl.AclInheritanceType)

Bir öğe, EKL'sini bir üst öğeden devraldığında uygulanacak erişim kurallarının türünü ayarlar. Bu, her zaman inheritAclFrom alanı ile birlikte ayarlanmalıdır. Ayrıca, inheritAclFrom alanı ayarlandığında bu alan geçerli bir AclInheritanceType olarak ayarlanmalıdır.

object (Principal)

Arama sonuçlarında öğeyi görmesine izin verilen ana hesapların listesi. İzinleri başka bir öğeden devralıyorsanız veya öğenin görünür olması amaçlanmamışsa (ör. virtual containers) isteğe bağlıdır. Maksimum öğe sayısı 1.000'dir.

object (Principal)

Arama sonuçlarında öğeye erişimi açık bir şekilde reddedilen ana hesapların listesi. Ana hesaplara erişim varsayılan olarak reddedilmiş olsa da istisnaları işlemek ve izin verilen okuyucuları geçersiz kılmak için reddedilen okuyucuları kullanın. Maksimum öğe sayısı 100'dür.

object (Principal)

İsteğe bağlı. Öğenin sahiplerinin listesi. Bu alanın doküman erişim izinleriyle bir ilgisi yoktur. Bununla birlikte, sorgulayan kullanıcının sahip olduğu öğeleri sıralamada küçük bir artışla güçlendirir. Maksimum öğe sayısı 5'tir.

{

  // Union field principal can be only one of the following:
  "gsuitePrincipal": {
    object (GSuitePrincipal)
  },
  "userResourceName": string,
  "groupResourceName": string
  // End of list of possible types for union field principal.
}

object (GSuitePrincipal)

Bu ana hesap bir Google Workspace kullanıcısı, grubu veya alandır.

string

Bu ana hesap, harici bir kimlik kullanarak tanımlanan kullanıcıdır. Ad alanında, kullanıcı kaynağı adı şu biçimde belirtilmelidir: Identitysources/{sourceId}/users/{ID}

string

Bu ana hesap, harici bir kimlik kullanılarak tanımlanan gruptur. Ad alanında, grup kaynağı adı şu biçimde belirtilmelidir: Identitysources/{sourceId}/groups/{ID}

{
  "title": string,
  "sourceRepositoryUrl": string,
  "containerName": string,
  "objectType": string,
  "createTime": string,
  "updateTime": string,
  "interactions": [
    {
      object (Interaction)
    }
  ],
  "contentLanguage": string,
  "mimeType": string,
  "searchQualityMetadata": {
    object (SearchQualityMetadata)
  },
  "keywords": [
    string
  ],
  "hash": string,
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}

string

Öğenin başlığı. Belirtilmişse bu, query.search sonucunun görüntülenen başlığı olur. En çok 2048 karakter kullanılabilir.

string

Verileri sunan kaynak deponun bağlantısı. Arama sonuçları bu bağlantıyı başlığa uygular. Boşluk veya özel karakterler, Cloud Seach sonuç bağlantılarının bir yönlendirme bildirimini tetiklemesine neden olabilir; Bunu önlemek için URL'yi kodlayın. En çok 2048 karakter kullanılabilir.

string

Bu öğenin kapsayıcısının adı. Kapsayıcı öğesinin silinmesi, bu öğenin otomatik olarak silinmesine neden olur. Not: EKL'ler bir kapsayıcı öğesinden devralınmaz. Bir öğeye EKL devralma ayarı sağlamak için inheritAclFrom alanını kullanın. En çok 1536 karakter kullanılabilir.

string

Öğenin türü. Bu, veri kaynağı için kayıtlı şemadaki bir nesne tanımının adına karşılık gelmelidir. Örneğin, veri kaynağına ait şema "document" adında bir nesne tanımı içeriyorsa bu türdeki nesnelere yönelik öğe dizine ekleme istekleri, itemType'ı "document" (doküman) olarak ayarlamalıdır. En çok 256 karakter kullanılabilir.

string (Timestamp format)

Öğenin kaynak depoda oluşturulduğu zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Öğenin kaynak depoda en son değiştirildiği zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

object (Interaction)

Öğeyle ilgili etkileşimlerin listesi. Etkileşimler, query.search kalitesini iyileştirmek için kullanılır ancak son kullanıcılara gösterilmez. Maksimum öğe sayısı 1.000'dir.

string

Öğenin BCP-47 dil kodu (ör. "en-US") veya "sr-Latn" girin. Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın. En çok 32 karakter kullanılabilir.

string

Kaynak depodaki ItemContent.content öğesinin orijinal mime türü. En çok 256 karakter kullanılabilir.

object (SearchQualityMetadata)

Öğenin ek arama kalitesi meta verileri

string

Öğeyle eşleşmesi gereken ek anahtar kelimeler veya kelime öbekleri. Kullanıcı tarafından oluşturulan içerik için dahili olarak kullanılır. Maksimum öğe sayısı 100'dür. En çok 8.192 karakter kullanılabilir.

string

API çağrısı tarafından sağlanan karma oluşturma değeri. Bu değer, değiştirilme durumunu hesaplamak için items.push yöntemiyle kullanılabilir. En çok 2048 karakter kullanılabilir.

object (ContextAttribute)

Öğeyle ilişkilendirilmiş bir adlandırılmış özellik grubu. Bu değer, istekteki bağlama göre öğenin sıralamasını etkilemek için kullanılabilir. Maksimum öğe sayısı 10'dur.

{
  "type": enum (Interaction.InteractionType),
  "principal": {
    object (Principal)
  },
  "interactionTime": string
}

enum (Interaction.InteractionType)

object (Principal)

Öğe üzerinde işlem yapan kullanıcı.

string (Timestamp format)

Kullanıcının öğe üzerinde işlem yaptığı zaman. Tek bir kullanıcı için aynı türde birden fazla işlem varsa yalnızca en son işlem kaydedilir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

{
  "quality": number
}

number

Arama kalitesini etkilemek için kullanılan, öğenin kalitesinin bir göstergesi. değer 0,0 (en düşük kalite) ile 1.0 (en yüksek kalite) arasında olmalıdır. Varsayılan değer 0,0'dır.

{
  "name": string,
  "values": [
    string
  ]
}

string

Özelliğin adı. Boş olmamalıdır. En çok 32 karakter kullanılabilir. Ad bir harfle başlamalıdır ve yalnızca harf (A-Z, a-z) veya rakam (0-9) içerebilir. Ad, eşleştirilmeden önce normalleştirilir (küçük harfle).

string

Özelliğin metin değerleri. Maksimum öğe sayısı 10'dur. Dizideki bir öğenin maksimum uzunluğu 32 karakterdir. Değer, eşleştirilmeden önce normalleştirilir (küçük harfle).

{
  "object": {
    object (StructuredDataObject)
  },
  "hash": string
}

object (StructuredDataObject)

Veri kaynağına ait şemada kayıtlı nesne tanımına uyması gereken yapılandırılmış veri nesnesi.

string

API çağrısı tarafından sağlanan karma oluşturma değeri. Bu değer, değiştirilme durumunu hesaplamak için items.push yöntemiyle kullanılabilir. En çok 2048 karakter kullanılabilir.

{
  "properties": [
    {
      object (NamedProperty)
    }
  ]
}

object (NamedProperty)

Nesnenin özellikleri. Maksimum öğe sayısı 1.000'dir.

{
  "name": string,

  // Union field value can be only one of the following:
  "integerValues": {
    object (NamedProperty.IntegerValues)
  },
  "doubleValues": {
    object (NamedProperty.DoubleValues)
  },
  "timestampValues": {
    object (NamedProperty.TimestampValues)
  },
  "booleanValue": boolean,
  "objectValues": {
    object (NamedProperty.ObjectValues)
  },
  "enumValues": {
    object (NamedProperty.EnumValues)
  },
  "dateValues": {
    object (NamedProperty.DateValues)
  },
  "textValues": {
    object (NamedProperty.TextValues)
  },
  "htmlValues": {
    object (NamedProperty.HtmlValues)
  }
  // End of list of possible types for union field value.
}

string

Tesisin adı. Bu ad, şemada nesne tanımı için kaydedilen özelliğin adına karşılık gelmelidir. Bu tesis için izin verilen maksimum uzunluk 256 karakterdir.

object (NamedProperty.IntegerValues)

object (NamedProperty.DoubleValues)

object (NamedProperty.TimestampValues)

boolean

object (NamedProperty.ObjectValues)

object (NamedProperty.EnumValues)

object (NamedProperty.DateValues)

object (NamedProperty.TextValues)

object (NamedProperty.HtmlValues)

{
  "values": [
    string
  ]
}

string (int64 format)

{
  "values": [
    number
  ]
}

number

{
  "values": [
    string
  ]
}

string (Timestamp format)

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

{
  "values": [
    {
      object (StructuredDataObject)
    }
  ]
}

object (StructuredDataObject)

{
  "values": [
    string
  ]
}

string

Dize değerleri için izin verilen maksimum uzunluk 32 karakterdir.

{
  "values": [
    {
      object (Date)
    }
  ]
}

object (Date)

{
  "values": [
    string
  ]
}

string

Metin değerleri için izin verilen maksimum uzunluk 2048 karakterdir.

{
  "values": [
    string
  ]
}

string

HTML değerleri için izin verilen maksimum uzunluk 2048 karakterdir.

{
  "contentFormat": enum (ItemContent.ContentFormat),
  "hash": string,

  // Union field content can be only one of the following:
  "inlineContent": string,
  "contentDataRef": {
    object (UploadItemRef)
  }
  // End of list of possible types for union field content.
}

enum (ItemContent.ContentFormat)

string

İçerik için API istemcisi tarafından hesaplanan ve sağlanan karma oluşturma bilgileri. Değiştirilme durumunu hesaplamak için items.push yöntemiyle kullanılabilir. En çok 2048 karakter kullanılabilir.

string (bytes format)

Güncelleme yönteminde satır içi olarak sağlanan içerik. Maksimum uzunluk 102.400 bayttır (100 KiB).

base64 kodlu bir dize.

object (UploadItemRef)

Yazma yöntemiyle daha önce yüklenmiş bir içeriğin referans kimliğini yükleyin.

{
  "name": string
}

string

İçerik referansının adı. En çok 2048 karakter kullanılabilir.

{
  "code": enum (ItemStatus.Code),
  "processingErrors": [
    {
      object (ProcessingError)
    }
  ],
  "repositoryErrors": [
    {
      object (RepositoryError)
    }
  ]
}

enum (ItemStatus.Code)

Durum kodu.

object (ProcessingError)

Öğenin ERROR (HATA) durumunda olması ihtimaline ilişkin hata ayrıntıları.

object (RepositoryError)

Bağlayıcı tarafından bildirilen depo hatası.

{
  "code": enum (ProcessingErrorCode),
  "errorMessage": string,
  "fieldViolations": [
    {
      object (FieldViolation)
    }
  ]
}

enum (ProcessingErrorCode)

Hatanın türünü gösteren hata kodu.

string

Hatanın açıklaması.

object (FieldViolation)

Öğe alanlarının geçersiz olması durumunda bu alanda doğrulama hatalarıyla ilgili ayrıntılar yer alır.

{
  "field": string,
  "description": string
}

string

İhlal içeren alan yolu.

string

Hatanın açıklaması.

{
  "type": enum (RepositoryError.Type),
  "httpStatusCode": integer,
  "errorMessage": string
}

enum (RepositoryError.Type)

Hatanın türü.

integer

Hata kodları. HTTP durum kodlarının tanımıyla eşleşir.

string

Hatayı açıklayan mesaj. Mesajın izin verilen maksimum uzunluğu 8.192 karakterdir.