GASでスプレッドシートの行または列全体に開発者メタデータを追加する

開発者メタデータのキーを追加する：addDeveloperMetadata(key)

行または列全体に開発者メタデータのキーを追加します。

パラメータ

名前	タイプ	説明
key	string	開発者メタデータのキー名

戻り値

Range

セルの範囲

行に開発者メタデータのキーを追加する

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('A:A').addDeveloperMetadata("test");
}

列全体に開発者メタデータのキーを追加する

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('1:1').addDeveloperMetadata("test");
}

公式ドキュメント：Range > addDeveloperMetadata(key)

開発者メタデータのキーとアクセス種別を追加する：addDeveloperMetadata(key, visibility)

行または列全体に開発者メタデータのキーとアクセス種別を追加します。

パラメータ

名前	タイプ	説明
key	string	開発者メタデータのキー名
visibility	DeveloperMetadataVisibility	DOCUMENT:ドキュメントアクセスできる人 PROJECT:プロジェクトにアクセスできる人

戻り値

Range

セルの範囲

行に開発者メタデータのキーを追加する(DOCUMENTの場合)

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('A:A').addDeveloperMetadata("test",SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);
}

列全体に開発者メタデータのキーを追加する(PROJECTの場合)

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('1:1').addDeveloperMetadata("test",SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);
}

公式ドキュメント：Range > addDeveloperMetadata(key, visibility)

開発者メタデータのキーと値を追加する：addDeveloperMetadata(key, value) 

行または列全体に開発者メタデータのキーと値を追加します。

パラメータ

名前	タイプ	説明
key	string	開発者メタデータのキー名
value	string	開発者メタデータのキーに紐づく値

戻り値

Range

セルの範囲

行に開発者メタデータのキーと値を追加する

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('A:A').addDeveloperMetadata("test","hoge");
}

列全体に開発者メタデータのキーと値を追加する

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('1:1').addDeveloperMetadata("test","fuga");
}

公式ドキュメント：Range > addDeveloperMetadata(key, value) 

開発者メタデータのキーと値とアクセス種別を追加する：addDeveloperMetadata(key, value, visibility)

行または列全体に開発者メタデータのキーと値とアクセス種別を追加します。

パラメータ

名前	タイプ	説明
key	string	開発者メタデータのキー名
value	string	開発者メタデータのキーに紐づく値
visibility	DeveloperMetadataVisibility	DOCUMENT:ドキュメントアクセスできる人 PROJECT:プロジェクトにアクセスできる人

戻り値

Range

セルの範囲

行に開発者メタデータのキーと値を追加する(DOCUMENTの場合)

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('A:A').addDeveloperMetadata("test","hoge",SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);
}

列全体に開発者メタデータのキー値を追加する(PROJECTの場合)

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const range = sheet.getRange('1:1').addDeveloperMetadata("test","fuga",SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);
}

公式ドキュメント：Range > addDeveloperMetadata(key, value, visibility)

まとめ