Method: labels.disable

公開済みのラベルを無効にします。ラベルを無効にすると、現在公開されているリビジョンに基づいて、新たに無効化された公開リビジョンが作成されます。下書きのリビジョンがある場合は、最新の下書きリビジョンに基づいて、無効な下書きのリビジョンが新規作成されます。古い下書きの版は削除されます。

無効にしたラベルは labels.delete で削除できます。

HTTP リクエスト

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。ラベルのリソース名。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
フィールド
updateMask

string (FieldMask format)

更新対象のフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート disabledPolicy は暗黙的に指定されるため、指定しないでください。1 つの * を使用して、すべてのフィールドを更新するための省略形を使用できます。

useAdminAccess

boolean

ユーザーの管理者認証情報を使用するには、true に設定します。サーバーは、アクセスを許可する前に、ユーザーがラベルの管理者であることを確認します。

writeControl

object (WriteControl)

書き込みリクエストの実行方法を制御します。デフォルトは未設定で、最後の書き込みが優先されます。

disabledPolicy

object (DisabledPolicy)

使用するポリシーを無効にしました。

languageCode

string

ローカライズされたフィールド ラベルの評価に使用する BCP-47 言語コード。指定しない場合は、デフォルトで構成されている言語の値が使用されます。

レスポンスの本文

成功した場合、レスポンスの本文には Label のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

詳細については、承認ガイドをご覧ください。