Method: labels.delta

Bir dizi güncelleme isteği uygulayarak tek bir Etiketi günceller ve sonuçta yeni bir taslak düzeltmesi elde edilir. Toplu güncelleme ya hep ya da hiç: Güncelleme isteklerinden herhangi biri geçersizse hiçbir değişiklik uygulanmaz. Ortaya çıkan taslak düzeltmenin, değişikliklerin Drive Öğeleri'nde kullanılabilmesi için yayınlanması gerekir.

HTTP isteği

POST https://drivelabels.googleapis.com/v2beta/{name=labels/*}:delta

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

Yol parametreleri

Parametreler
name

string

Zorunlu. Güncellenecek Etiketin kaynak adı.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "writeControl": {
    object (WriteControl)
  },
  "requests": [
    {
      object (Request)
    }
  ],
  "useAdminAccess": boolean,
  "view": enum (LabelView),
  "languageCode": string
}
Alanlar
writeControl

object (WriteControl)

Yazma isteklerinin yürütülme şekli üzerinde kontrol sağlar.
requests[]

object (Request)

Etikete uygulanacak güncellemelerin listesi. İstekler belirtildikleri sıraya göre uygulanır.
useAdminAccess

boolean

Kullanıcının yönetici kimlik bilgilerini kullanmak için true olarak ayarlayın. Sunucu, erişime izin vermeden önce kullanıcının Etiket için yönetici olduğunu doğrular.
view

enum (LabelView)

Belirtildiğinde, yalnızca belirtilen görünüme ait belirli alanlar döndürülür.
languageCode

string

include_label_in_response true olduğunda yerelleştirilmiş Alan etiketlerini değerlendirmek için kullanılacak BCP-47 dil kodu.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Etiket güncellemesi yanıtı.

JSON gösterimi 
{
  "responses": [
    {
      object (Response)
    }
  ],
  "updatedLabel": {
    object (Label)
  }
}
Alanlar
responses[]

object (Response)

Güncellemelerin yanıtı. Bu, bazı isteklere verilen yanıtlar boş görünse de, bire bir güncellemelerle eşlenir.
updatedLabel

object (Label)

Güncellemeler uygulandıktan sonraki etiket. Bu ayar yalnızca [BatchUpdateLabelResponse2.include_label_in_response] öğesi true ise ve herhangi bir hata oluşmadıysa ayarlanır.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

İstek

Bir etikete uygulanacak tek bir güncelleme türü.

JSON gösterimi 
{

  // Union field kind can be only one of the following:
  "updateLabel": {
    object (UpdateLabelPropertiesRequest)
  },
  "createField": {
    object (CreateFieldRequest)
  },
  "updateField": {
    object (UpdateFieldPropertiesRequest)
  },
  "updateFieldType": {
    object (UpdateFieldTypeRequest)
  },
  "enableField": {
    object (EnableFieldRequest)
  },
  "disableField": {
    object (DisableFieldRequest)
  },
  "deleteField": {
    object (DeleteFieldRequest)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceRequest)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesRequest)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceRequest)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceRequest)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceRequest)
  }
  // End of list of possible types for union field kind.
}
Alanlar
Birleştirme alanı kind. Güncellemenin türü. Tam olarak bir Alan gereklidir. kind şunlardan yalnızca biri olabilir:
updateLabel

object (UpdateLabelPropertiesRequest)

Etiket özelliklerini günceller.
createField

object (CreateFieldRequest)

Yeni bir alan oluşturur.
updateField

object (UpdateFieldPropertiesRequest)

Bir Alanın temel özelliklerini günceller.
updateFieldType

object (UpdateFieldTypeRequest)

Alan türü ve/veya türü seçeneklerini güncelleyin.
enableField

object (EnableFieldRequest)

Alanı etkinleştirir.
disableField

object (DisableFieldRequest)

Alanı devre dışı bırakır.
deleteField

object (DeleteFieldRequest)

Etiketten bir Alanı siler.
createSelectionChoice

object (CreateSelectionChoiceRequest)

Bir Seçim alanında Seçim oluşturur.
updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesRequest)

Bir Seçim Alanı içindeki Seçenek özelliklerini güncelleme.
enableSelectionChoice

object (EnableSelectionChoiceRequest)

Bir Seçim Alanında Bir Seçimi etkinleştirin.
disableSelectionChoice

object (DisableSelectionChoiceRequest)

Bir Seçim Alanındaki Seçimi devre dışı bırakma.
deleteSelectionChoice

object (DeleteSelectionChoiceRequest)

Seçim Alanındaki bir Seçeneği silme.

UpdateLabelPropertiesRequest

Etiketin temel özelliklerini günceller.

JSON gösterimi 
{
  "updateMask": string,
  "properties": {
    object (Properties)
  }
}
Alanlar
updateMask

string (FieldMask format)

Güncellenmesi gereken alanlar. En az bir alan belirtilmelidir. label_properties kökü örtülüdür ve belirtilmemelidir. Her alanı güncellemek için tek bir * kısaltması olarak kullanılabilir.
properties

object (Properties)

Zorunlu. Güncellenecek etiket özellikleri.

CreateFieldRequest

Bir Etiket içinde Alan oluşturma isteği.

JSON gösterimi 
{
  "field": {
    object (Field)
  }
}
Alanlar
field

object (Field)

Zorunlu. Oluşturulacak alan.

UpdateFieldPropertiesRequest

Alan özelliklerini güncelleme isteği.

JSON gösterimi 
{
  "updateMask": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
Alanlar
updateMask

string (FieldMask format)

Güncellenmesi gereken alanlar. En az bir alan belirtilmelidir. properties kökü örtülüdür ve belirtilmemelidir. Her alanı güncellemek için tek bir * kısaltması olarak kullanılabilir.
id

string

Zorunlu. Güncellenecek alan.
properties

object (Properties)

Zorunlu. Temel Alan özellikleri.

UpdateFieldTypeRequest

Bir Alanın türünü değiştirme isteği.

JSON gösterimi 
{
  "updateMask": string,
  "id": string,

  // Union field type_options can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "longTextOptions": {
    object (LongTextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
  // End of list of possible types for union field type_options.
}
Alanlar
updateMask

string (FieldMask format)

Güncellenmesi gereken alanlar. En az bir alan belirtilmelidir. type_options kökü örtüktür ve belirtilmemelidir. Her alanı güncellemek için tek bir * kısaltması olarak kullanılabilir.
id

string

Zorunlu. Güncellenecek alan.

Birleştirme alanı type_options.

type_options şunlardan yalnızca biri olabilir:
textOptions

object (TextOptions)

Alanı Metin olarak güncelleyin.
longTextOptions

object (LongTextOptions)

Alanı Uzun Metin olarak güncelleyin.
integerOptions

object (IntegerOptions)

Alanı Tamsayı olarak güncelleyin.
dateOptions

object (DateOptions)

Alanı Tarih olarak güncelleyin.
selectionOptions

object (SelectionOptions)

Alanı seçim olarak güncelleyin.
userOptions

object (UserOptions)

Alanı Kullanıcı olarak güncelleyin.

LongTextOptions

Uzun Metin alan türü için seçenekler.

JSON gösterimi 
{
  "minLength": integer,
  "maxLength": integer
}
Alanlar
minLength

integer

Yalnızca çıkış. Metin alanı için geçerli minimum değer uzunluğu.
maxLength

integer

Yalnızca çıkış. Metin alanı için geçerli maksimum değer uzunluğu.

EnableFieldRequest

Alanı etkinleştirme isteği.

JSON gösterimi 
{
  "id": string
}
Alanlar
id

string

Zorunlu. Etkinleştirilecek Alanın kimliği.

DisableFieldRequest

Alanı devre dışı bırakma isteği.

JSON gösterimi 
{
  "updateMask": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Alanlar
updateMask

string (FieldMask format)

Güncellenmesi gereken alanlar. En az bir alan belirtilmelidir. disabledPolicy kökü örtülüdür ve belirtilmemelidir. Her alanı güncellemek için tek bir * kısaltması olarak kullanılabilir.
id

string

Zorunlu. Devre dışı bırakılacak Alanın anahtarı.
disabledPolicy

object (DisabledPolicy)

Zorunlu. Alanda Devre Dışı Bırakma Politikası.

DeleteFieldRequest

Alanı silme isteği gönderin.

JSON gösterimi 
{
  "id": string
}
Alanlar
id

string

Zorunlu. Silinecek Alanın kimliği.

CreateSelectionChoiceRequest

Seçim Seçimi oluşturma isteği.

JSON gösterimi 
{
  "fieldId": string,
  "choice": {
    object (Choice)
  }
}
Alanlar
fieldId

string

Zorunlu. Bir Seçimin oluşturulacağı Seçim Alanı.
choice

object (Choice)

Zorunlu. İçerik üretme tercihi.

UpdateSelectionChoicePropertiesRequest

Bir Choice özelliklerini güncelleme isteğinde bulunun.

JSON gösterimi 
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
Alanlar
updateMask

string (FieldMask format)

Güncellenmesi gereken alanlar. En az bir alan belirtilmelidir. properties kökü örtülüdür ve belirtilmemelidir. Her alanı güncellemek için tek bir * kısaltması olarak kullanılabilir.
fieldId

string

Zorunlu. Güncellenecek Seçim Alanı.
id

string

Zorunlu. Güncelleme tercihi.
properties

object (Properties)

Zorunlu. Güncellenecek Seçenek özellikleri.

EnableSelectionChoiceRequest

Bir Seçeneği etkinleştirme isteği.

JSON gösterimi 
{
  "fieldId": string,
  "id": string
}
Alanlar
fieldId

string

Zorunlu. Bir Seçimin etkinleştirileceği Seçim Alanı.
id

string

Zorunlu. Etkinleştirme seçeneği.

DisableSelectionChoiceRequest

Bir Seçeneği devre dışı bırakma isteği.

JSON gösterimi 
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Alanlar
updateMask

string (FieldMask format)

Güncellenmesi gereken alanlar. En az bir alan belirtilmelidir. disabledPolicy kökü örtülüdür ve belirtilmemelidir. Her alanı güncellemek için tek bir * kısaltması olarak kullanılabilir.
fieldId

string

Zorunlu. Bir Seçimin devre dışı bırakılacağı Seçim Alanı.
id

string

Zorunlu. Devre dışı bırakma seçeneği.
disabledPolicy

object (DisabledPolicy)

Zorunlu. Güncellenecek devre dışı bırakılmış politika.

DeleteSelectionChoiceRequest

Bir Seçimi silme isteği gönderin.

JSON gösterimi 
{
  "fieldId": string,
  "id": string
}
Alanlar
fieldId

string

Zorunlu. Bir Seçimin silineceği Seçim Alanı.
id

string

Zorunlu. Silme seçeneği.

Yanıt

Bir güncellemeden tek bir yanıt.

JSON gösterimi 
{

  // Union field response can be only one of the following:
  "updateLabel": {
    object (UpdateLabelPropertiesResponse)
  },
  "createField": {
    object (CreateFieldResponse)
  },
  "updateField": {
    object (UpdateFieldPropertiesResponse)
  },
  "updateFieldType": {
    object (UpdateFieldTypeResponse)
  },
  "enableField": {
    object (EnableFieldResponse)
  },
  "disableField": {
    object (DisableFieldResponse)
  },
  "deleteField": {
    object (DeleteFieldResponse)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceResponse)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesResponse)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceResponse)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceResponse)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceResponse)
  }
  // End of list of possible types for union field response.
}
Alanlar
Birleştirme alanı response. İlgili isteğin yanıtı. response şunlardan yalnızca biri olabilir:
updateLabel

object (UpdateLabelPropertiesResponse)

Bir Etiketin temel özellikleri güncellendi.
createField

object (CreateFieldResponse)

Yeni bir alan oluşturur.
updateField

object (UpdateFieldPropertiesResponse)

Bir Alanın temel özelliklerini günceller.
updateFieldType

object (UpdateFieldTypeResponse)

Alan türü ve/veya türü seçeneklerini güncelleyin.
enableField

object (EnableFieldResponse)

Alanı Etkinleştirir.
disableField

object (DisableFieldResponse)

Alanı Devre Dışı Bırakır.
deleteField

object (DeleteFieldResponse)

Etiketten bir Alanı siler.
createSelectionChoice

object (CreateSelectionChoiceResponse)

Seçim Alanına eklemek üzere yeni bir seçim listesi seçeneği oluşturur.
updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesResponse)

Bir Seçim Alanındaki Seçenekleri günceller.
enableSelectionChoice

object (EnableSelectionChoiceResponse)

Bir Seçim Alanı içinde Seçim yapılmasını sağlar.
disableSelectionChoice

object (DisableSelectionChoiceResponse)

Bir Seçim Alanındaki Seçimi devre dışı bırakır.
deleteSelectionChoice

object (DeleteSelectionChoiceResponse)

Seçim Alanından bir Seçeneği siler.

UpdateLabelPropertiesResponse

Etiket özelliklerinde güncellemenin ardından yanıt.

CreateFieldResponse

Alan oluşturma işleminden sonra yanıt.

JSON gösterimi 
{
  "id": string,
  "priority": integer
}
Alanlar
id

string

Oluşturulan alanın alanı. Oluşturma isteğinde boş bırakıldığında otomatik olarak bir anahtar oluşturulur ve burada tanımlanabilir.
priority

integer

Oluşturulan alanın önceliği. Öncelik, alanlar arasındaki bitişik önceliklerin sağlanması için belirtilenden farklı olabilir (1-n).

UpdateFieldPropertiesResponse

Alan özelliklerinde güncelleme yaptıktan sonra verilen yanıt.

JSON gösterimi 
{
  "priority": integer
}
Alanlar
priority

integer

Güncellenen alanın önceliği. Öncelik, alanlar arasındaki bitişik önceliklerin sağlanması için belirtilenden farklı olabilir (1-n).

UpdateFieldTypeResponse

Alan türünde güncelleme yaptıktan sonra verilen yanıt.

EnableFieldResponse

Alan etkinleştirildikten sonra yanıt.

DisableFieldResponse

Alan devre dışı bırakıldıktan sonra yanıt.

DeleteFieldResponse

Alan silme işleminden sonra yanıt.

CreateSelectionChoiceResponse

Seçim Seçimi oluşturduktan sonra yanıt.

JSON gösterimi 
{
  "fieldId": string,
  "id": string
}
Alanlar
fieldId

string

Alanın sunucu tarafından oluşturulan kimliği.
id

string

Alan içinde oluşturulan seçimin sunucu tarafından oluşturulan kimliği

UpdateSelectionChoicePropertiesResponse

Seçim Seçeneği özellikleri güncellendikten sonra verilen yanıt.

JSON gösterimi 
{
  "priority": integer
}
Alanlar
priority

integer

Güncellenen seçeneğin önceliği. Öncelik, seçenekler arasındaki bitişik önceliklerin sağlanması için belirtilenden farklı olabilir (1-n).

EnableSelectionChoiceResponse

Seçim etkinleştirildikten sonra yanıt ver.

DisableSelectionChoiceResponse

Seçim devre dışı bırakıldıktan sonra yanıt ver.

DeleteSelectionChoiceResponse

Seçim silindikten sonra yanıt.