ラベルを更新する

一連の更新リクエストを適用することで、単一のラベルを更新できます。 新しい下書きのリビジョンを作成します。たとえば、既存のラベルを更新したり、 property（ラベル カスタム ディメンションを追加することも、 ラベルに Field を追加します。

メソッドが更新のリストを受け取るため、ラベル更新は一括更新として機能します。 Request オブジェクト。これは、 バッチ リクエストで指定された順序で更新を行います。「 更新はアトミックに適用されます。つまり、API 呼び出しに バッチも失敗すると 更新全体が失敗し （依存関係にある可能性がある）変更が適用されます。ラベルは変更されません。

更新に成功したら、変更後のドラフト リビジョンを公開する必要があります ドライブのアイテムに変更を使用できるようになります

ラベル オブジェクトを更新する

ラベルには、他にも次のような、更新可能なオブジェクト タイプが多数あります。

  • ラベルのプロパティ
  • フィールドとフィールド型
  • 選択の選択肢と選択の選択のプロパティ

これらは、デザインや操作を制御する多くのオブジェクトの一部で、 指定します。

オペレーションのカテゴリ

次のオペレーションは、 labels.delta メソッド 大まかに分類すると、

カテゴリ 説明
作成オブジェクトを追加します。
更新オブジェクトの特定のプロパティを更新します。
有効にするオブジェクトを有効にする。
無効化オブジェクトを無効にする。
削除オブジェクトを削除する。

次のセクションでは、これらのカテゴリを使用して、VM の 使用できます。

更新リクエスト

labels.delta メソッドが機能する 1 つ以上 Request オブジェクトは、 1 つは実行するリクエストのタイプを 1 つ指定するものです。データ アナリストが 処理できます。リクエストの種類を次のカテゴリに分類して分類すると、 あります。

リクエストの種類
ラベルのプロパティ
更新 UpdateLabelPropertiesRequest
フィールド
作成 CreateFieldRequest
更新 UpdateFieldPropertiesRequest
UpdateFieldTypeRequest
有効にする EnableFieldRequest
無効にする DisableFieldRequest
削除 DeleteFieldRequest
選択の選択
作成 CreateSelectionChoiceRequest
更新 UpdateSelectionChoicePropertiesRequest
有効にする EnableSelectionChoiceRequest
無効にする DisableSelectionChoiceRequest
削除 DeleteSelectionChoiceRequest

フィールド マスク

「更新」セクションの多くは、[無効にする] を選択します。タイプ リクエストには FieldMask。 これは、フィールドを離れて更新するフィールドのカンマ区切りのリストです。 変更されることはありません。マスクは、指定したフィールドのみが 更新されます。少なくとも 1 つのフィールドを指定する必要があります。

例

ラベルを更新するには、 次のオブジェクトの delta メソッド: labels コレクション。

次の項目も指定する必要があります。

  • ユーザーの管理者認証情報を使用する場合、useAdminAccess は true です。「 ユーザーがラベルの管理者であることを確認したうえで、管理者がラベルの できます。

  • Request: ラベルに適用する更新を指定します。

  • ラベル title property メソッドを使用します。

  • 1 つ以上の Field。

  • ラベルリソース ラベルを表す名前です。これには、リソース Name と ID が含まれています。 ラベルのグローバルに一意の識別子です。

  • LabelView: LABEL_VIEW_FULL は、ラベルの回答に適用するリソースビューを設定します。 LABEL_VIEW_FULL は指定可能なすべてのフィールドを返します。

この例では、ID を使用して正しいラベルを更新します。

Python

body = {
'use_admin_access': True,
'requests': [{
  'update_label': {
    'properties': {
      'title': 'TITLE'
    },
    'update_mask': {
      'paths': ['title']
    }
  },
}, {
  'create_field': {
    'field': {
      'properties': {
        'display_name': 'DISPLAY_NAME'
      },
      'text_options': {}
    }
  }
}],
'view': 'LABEL_VIEW_FULL'
}
response = service.labels().delta(
  body=body,
  name='labels/ID').execute()

Node.js

var body = {
  'use_admin_access': true,
  'requests': [{
    'update_label': {
      'properties': {
        'title': 'TITLE'
      },
      'update_mask': {
        'paths': ['title']
      }
    },
  }, {
    'create_field': {
      'field': {
        'properties': {
          'display_name': 'DISPLAY_NAME'
        },
        'text_options': {}
      }
    }
  }],
  'view': 'LABEL_VIEW_FULL'
};
service.labels.delta({
  'resource': body,
  'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ラベル、フィールド、選択肢が更新された場合、ラベルのリビジョン ID が加算されます。 ラベルはドラフトラベルとしてデータベースに保存されます。ラベルに State / PUBLISHED 件 hasUnpublishedChanges=true は、下書きの変更があるが、実際にはないことを意味します。 ユーザーに提供します更新されたラベルは、変更前の PUBLISHED になっている必要があります ユーザーに表示されます詳細については、ラベル 説明します。