ラベルのライフサイクル

ラベル、フィールド、選択肢は、そのライフサイクル全体で特定の状態を経ます。また、ラベルのリビジョンが異なる場合もあります。次の図は、リビジョン処理を含むラベルのライフサイクルを示しています。

ラベルのライフサイクルの図。
図 3. ラベルのライフサイクル
  1. ラベルを作成する（create()） - ラベルが作成され、revision_id=1 としてデータベースに保存されます。ラベルの状態は UNPUBLISHED_DRAFT です。この状態の場合:
    • ユーザーがラベルを表示できない
    • ユーザーはドライブのアイテムにラベルを適用できません。
  2. （省略可）ラベル、項目、選択肢を更新する（delta()） - 公開前でも、すべての更新がデータベースに保存され、ラベルのリビジョンが増分されます。
  3. ラベルを公開する（publish()） - ラベルの状態は PUBLISHED で、ユーザーはラベルを適用できます。ラベルを公開すると、リビジョンが増加します。
  4. （省略可）ラベル、フィールド、選択肢を更新する（delta()） - ラベル、フィールド、選択肢が更新され、ドラフトラベルとしてデータベースに保存されます。ラベルの状態は PUBLISHED で、hasUnpublishedChanges=true は未公開の変更があることを意味します。ユーザーは未公開の変更を使用できません。更新ごとにラベルのリビジョンが増加します。
  5. （省略可）ラベルを公開する（publish()） - 利用可能な場合は、最新の下書きが公開されます。ラベルの状態は PUBLISHED で、ユーザーはラベルを適用できます。ラベルを公開すると、バージョンが増分されます。
  6. ラベルを無効にする（disable()） - ラベルの状態は DISABLED ですが、ユーザーは API を使用してラベルを適用できます。ただし、無効なラベルは、表示するように構成されていない限り、UI に表示されません。ラベルの非推奨化により、リビジョンが増加します。
  7. ラベルを有効にする（enable()） - ラベルは PUBLISHED 状態に戻り、ユーザーはラベルを適用できます。ラベルを公開すると、リビジョンが増加します。
  8. ラベルを削除する（delete()） - ラベルの状態が DELETED で、適用できません。削除されたラベルは最終的にパージされます。

ラベルを更新するたびに、ラベルのリビジョンが増加します。ラベルがすでに公開されている場合、n 回更新した後に再度公開すると、公開されるリビジョン番号はリビジョン + n + 1 回連続した更新数になります。