Class Protection

Koruma

Korunan aralıklara ve sayfalara erişebilir ve bu aralıklarda değişiklik yapabilir. Korunan bir aralık, statik bir hücre aralığını veya adlandırılmış bir aralığı koruyabilir. Korumalı bir sayfa, korumasız bölgeler içerebilir. Google E-Tablolar'ın eski sürümüyle oluşturulan e-tablolar için bunun yerine PageProtection sınıfını kullanın.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

// Remove all range protections in the spreadsheet that the user has permission
// to edit.
const ss = SpreadsheetApp.getActive();
const protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Protect the active sheet, then remove all other users from the list of
// editors.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addEditor(emailAddress)	Protection	Belirtilen kullanıcıyı, korunan sayfanın veya aralığın düzenleyicileri listesine ekler.
addEditor(user)	Protection	Belirtilen kullanıcıyı, korunan sayfanın veya aralığın düzenleyicileri listesine ekler.
addEditors(emailAddresses)	Protection	Belirtilen kullanıcı dizisini, korunan sayfanın veya aralığın düzenleyiciler listesine ekler.
addTargetAudience(audienceId)	Protection	Belirtilen hedef kitleyi, korumalı aralığın düzenleyicisi olarak ekler.
canDomainEdit()	Boolean	Elektronik tablonun sahibi olan alan adındaki tüm kullanıcıların, korumalı aralığı veya sayfayı düzenleme iznine sahip olup olmadığını belirler.
canEdit()	Boolean	Kullanıcının, korunan aralığı veya sayfayı düzenleme izni olup olmadığını belirler.
getDescription()	String	Korunan aralığın veya sayfanın açıklamasını alır.
getEditors()	User[]	Korunan aralık veya sayfanın düzenleyenlerinin listesini alır.
getProtectionType()	ProtectionType	Korunan alanın türünü (RANGE veya SHEET) alır.
getRange()	Range	Korunan aralığı alır.
getRangeName()	String	Adlandırılmış bir aralıkla ilişkilendirilmişse korunan aralığın adını alır.
getTargetAudiences()	TargetAudience[]	Korunan aralığı düzenleyebilecek hedef kitlelerin kimliklerini döndürür.
getUnprotectedRanges()	Range[]	Korunan bir sayfadaki korumasız aralıklardan oluşan bir dizi döndürür.
isWarningOnly()	Boolean	Korunan alanda "uyarı tabanlı" korumanın kullanılıp kullanılmadığını belirler.
remove()	void	Aralığın veya sayfanın korumasını kaldırır.
removeEditor(emailAddress)	Protection	Belirtilen kullanıcıyı, korumalı sayfanın veya aralığın düzenleyiciler listesinden kaldırır.
removeEditor(user)	Protection	Belirtilen kullanıcıyı, korumalı sayfanın veya aralığın düzenleyiciler listesinden kaldırır.
removeEditors(emailAddresses)	Protection	Belirtilen kullanıcı dizisini, korumalı sayfanın veya aralığın düzenleyiciler listesinden kaldırır.
removeTargetAudience(audienceId)	Protection	Belirtilen hedef kitleyi, korunan aralığın düzenleyicisi olarak kaldırır.
setDescription(description)	Protection	Korunan aralığın veya sayfanın açıklamasını belirler.
setDomainEdit(editable)	Protection	E-tablonun sahibi olan alandaki tüm kullanıcıların, korumalı aralığı veya sayfayı düzenleme iznine sahip olup olmadığını belirler.
setNamedRange(namedRange)	Protection	Korunan aralığı mevcut bir adlandırılmış aralıkla ilişkilendirir.
setRange(range)	Protection	Korunan aralığı ayarlar.
setRangeName(rangeName)	Protection	Korunan aralığı mevcut bir adlandırılmış aralıkla ilişkilendirir.
setUnprotectedRanges(ranges)	Protection	Korunan bir sayfadaki belirli aralık dizisinin korumasını kaldırır.
setWarningOnly(warningOnly)	Protection	Bu korumalı aralığın "uyarı tabanlı" koruma kullanıp kullanmadığını belirler.

Ayrıntılı dokümanlar

addEditor(emailAddress)

Belirtilen kullanıcıyı, korunan sayfanın veya aralığın düzenleyicileri listesine ekler. Bu yöntem, kullanıcıya e-tabloyu düzenleme iznini otomatik olarak vermez. Bunun için Spreadsheet.addEditor(emailAddress) işlevini de çağırmanız gerekir.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Adds an editor to the spreadsheet using an email address.
// TODO(developer): Replace the email address with a valid email.
ss.addEditor('[e-mail]');

// Gets a sheet by its name and protects it.
const sheet = ss.getSheetByName('Sheet1');
const sampleProtectedSheet = sheet.protect();

// Adds an editor of the protected sheet using an email address.
// TODO(developer): Replace the email address with a valid email.
sampleProtectedSheet.addEditor('[e-mail]');

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parametreler

Ad	Tür	Açıklama
emailAddress	String	Eklenecek kullanıcının e-posta adresi.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addEditor(user)

Belirtilen kullanıcıyı, korunan sayfanın veya aralığın düzenleyicileri listesine ekler. Bu yöntem, kullanıcıya e-tabloyu düzenleme iznini otomatik olarak vermez. Bunun için Spreadsheet.addEditor(user) işlevini de çağırmanız gerekir.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Adds the active user as an editor of the protected sheet.
sampleProtectedSheet.addEditor(Session.getActiveUser());

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parametreler

Ad	Tür	Açıklama
user	User	Eklenecek kullanıcının temsili.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addEditors(emailAddresses)

Belirtilen kullanıcı dizisini, korunan sayfanın veya aralığın düzenleyiciler listesine ekler. Bu yöntem, kullanıcılara e-tabloyu düzenleme iznini otomatik olarak vermez. Bunun için Spreadsheet.addEditors(emailAddresses) işlevini de çağırmanız gerekir.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Creates variables for the email addresses to add as editors.
// TODO(developer): Replace the email addresses with valid ones.
const TEST_EMAIL_1 = '[e-mail]';
const TEST_EMAIL_2 = '[e-mail]';

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Adds editors to the protected sheet using the email address variables.
sampleProtectedSheet.addEditors([TEST_EMAIL_1, TEST_EMAIL_2]);

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parametreler

Ad	Tür	Açıklama
emailAddresses	String[]	Eklenecek kullanıcıların e-posta adresleri dizisi.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

addTargetAudience(audienceId)

Belirtilen hedef kitleyi, korumalı aralığın düzenleyicisi olarak ekler.

Parametreler

Ad	Tür	Açıklama
audienceId	String	Eklenecek hedef kitlenin kimliği.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

canDomainEdit()

Elektronik tablonun sahibi olan alan adındaki tüm kullanıcıların, korumalı aralığı veya sayfayı düzenleme iznine sahip olup olmadığını belirler. Kullanıcının korunan aralığı veya sayfayı düzenleme izni yoksa istisna oluşturur.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Logs whether domain users have permission to edit the protected sheet to the
// console.
console.log(sampleProtectedSheet.canDomainEdit());

Return

Boolean: E-tablonun sahibi olan alandaki tüm kullanıcıların korumalı aralığı veya sayfayı düzenleme izni varsa true, yoksa false.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

canEdit()

Kullanıcının, korunan aralığı veya sayfayı düzenleme izni olup olmadığını belirler. E-tablo sahibi, korunan aralıkları ve sayfaları her zaman düzenleyebilir.

// Remove all range protections in the spreadsheet that the user has permission
// to edit.
const ss = SpreadsheetApp.getActive();
const protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Return

Boolean: Kullanıcının korumalı aralığı veya sayfayı düzenleme izni varsa true, yoksa false

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getDescription()

Korunan aralığın veya sayfanın açıklamasını alır. Açıklama ayarlanmamışsa bu yöntem boş bir dize döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet and sets the description.
const sampleProtectedSheet =
    sheet.protect().setDescription('Sample sheet is protected');

// Gets the description of the protected sheet and logs it to the console.
const sampleProtectedSheetDescription = sampleProtectedSheet.getDescription();
console.log(sampleProtectedSheetDescription);

Return

String: Korunan aralığın veya sayfanın açıklaması ya da açıklama ayarlanmamışsa boş bir dize.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getEditors()

Korunan aralık veya sayfanın düzenleyenlerinin listesini alır. Kullanıcının korunan aralığı veya sayfayı düzenleme izni yoksa istisna oluşturur.

// Protect the active sheet, then remove all other users from the list of
// editors.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Return

User[]: Korunan aralığı veya sayfayı düzenleme izni olan kullanıcı dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getProtectionType()

Korunan alanın türünü (RANGE veya SHEET) alır.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Gets the type of the protected area.
const protectionType = sampleProtectedSheet.getProtectionType();

// Logs 'SHEET'to the console since the type of the protected area is a sheet.
console.log(protectionType.toString());

Return

ProtectionType: Korunan alanın türü (RANGE veya SHEET).

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getRange()

Korunan aralığı alır. Koruma bir aralık yerine sayfa için geçerliyse bu yöntem, sayfanın tamamını kapsayan bir aralık döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range 'A1:B10' of Sheet1.
const range = sheet.getRange('A1:B10');

// Makes cells A1:B10 a protected range.
const sampleProtectedRange = range.protect();

// Gets the protected ranges on the sheet.
const protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);

// Logs the A1 notation of the first protected range on the sheet.
console.log(protections[0].getRange().getA1Notation());

Return

Range: Korunan aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getRangeName()

Adlandırılmış bir aralıkla ilişkilendirilmişse korunan aralığın adını alır. Koruma, adlandırılmış bir aralıkla ilişkilendirilmemişse null döndürülür. Komut dosyalarının, korumalı bir aralığı adlandırılmış bir aralıkla ilişkilendirmek için setRangeName(rangeName)'ü açıkça çağırması gerektiğini unutmayın. setRangeName(rangeName) çağrılmadan, adlandırılmış bir Range aralığında koruma oluşturmak için Range.protect() çağrılması, bu aralıkları ilişkilendirmek için yeterli değildir. Ancak Google E-Tablolar kullanıcı arayüzünde adlandırılmış bir aralıktan korumalı aralık oluşturduğunuzda bu iki öğe otomatik olarak ilişkilendirilir.

// Protect a named range in a spreadsheet and log the name of the protected
// range.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const protection = range.protect();
ss.setNamedRange('Test', range);  // Create a named range.
protection.setRangeName(
    'Test');  // Associate the protection with the named range.
Logger.log(
    protection.getRangeName());  // Verify the name of the protected range.

Return

String: Korunan adlandırılmış aralığın adı veya korunan aralık bir adlandırılmış aralıkla ilişkili değilse null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getTargetAudiences()

Korunan aralığı düzenleyebilecek hedef kitlelerin kimliklerini döndürür.

Return

TargetAudience[]: Hedef kitlelerin kimliklerinin dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getUnprotectedRanges()

Korunan bir sayfadaki korumasız aralıklardan oluşan bir dizi döndürür. Protection nesnesi, korunan bir sayfa yerine korunan bir aralığa karşılık geliyorsa bu yöntem boş bir dizi döndürür. Korunmayan aralıkları değiştirmek için setUnprotectedRanges(ranges) simgesini kullanarak yeni bir aralık dizisi ayarlayın. Sayfanın tamamını yeniden korumak için boş bir dizi ayarlayın.

// Unprotect cells E2:F5 in addition to any other unprotected ranges in the
// protected sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect();
const unprotected = protection.getUnprotectedRanges();
unprotected.push(sheet.getRange('E2:F5'));
protection.setUnprotectedRanges(unprotected);

Return

Range[]: Korunan bir sayfadaki korumasız aralık dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

isWarningOnly()

Korunan alanda "uyarı tabanlı" korumanın kullanılıp kullanılmadığını belirler. Uyarı tabanlı koruma, alandaki verileri her kullanıcının düzenleyebileceği anlamına gelir. Ancak düzenleme işlemi, kullanıcıdan düzenlemeyi onaylamasını isteyen bir uyarı gösterir. Korunan aralıklar veya sayfalar varsayılan olarak uyarıya dayalı değildir. Uyarıyı etkinleştirmek için setWarningOnly(warningOnly) simgesini kullanın.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Sets the warning status for the protected sheet as true.
sampleProtectedSheet.setWarningOnly(true);

const protectedSheetWarningStatus = sampleProtectedSheet.isWarningOnly();

// Logs the warning status of the protected sheet to the console.
console.log(protectedSheetWarningStatus);

Return

Boolean — Korunan aralık veya sayfa yalnızca uyarıya dayalı koruma kullanıyorsa true.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

remove()

Aralığın veya sayfanın korumasını kaldırır.

// Remove all range protections in the spreadsheet that the user has permission
// to edit.
const ss = SpreadsheetApp.getActive();
const protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove sheet protection from the active sheet, if the user has permission to
// edit it.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection?.canEdit()) {
  protection.remove();
}

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

removeEditor(emailAddress)

Belirtilen kullanıcıyı, korumalı sayfanın veya aralığın düzenleyiciler listesinden kaldırır. Kullanıcının, düzenleme iznine sahip bir Google grubunun üyesi olması veya alan adındaki tüm kullanıcıların düzenleme iznine sahip olması durumunda, kullanıcının korunan alanı düzenlemeye devam edebileceğini unutmayın. E-tablonun sahibi veya mevcut kullanıcı kaldırılamaz.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Creates a variable for an email address.
// TODO(developer): Replace the email address with a valid one.
const TEST_EMAIL = '[e-mail]';

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Adds an editor to the protected sheet using the email address variable.
sampleProtectedSheet.addEditor(TEST_EMAIL);

// Removes the editor from the protected sheet using the email address variable.
sampleProtectedSheet.removeEditor(TEST_EMAIL);

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parametreler

Ad	Tür	Açıklama
emailAddress	String	Kaldırılacak kullanıcının e-posta adresi.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

removeEditor(user)

Belirtilen kullanıcıyı, korumalı sayfanın veya aralığın düzenleyiciler listesinden kaldırır. Kullanıcının, düzenleme iznine sahip bir Google grubunun üyesi olması veya alan adındaki tüm kullanıcıların düzenleme iznine sahip olması durumunda, kullanıcının korunan alanı düzenleyebileceğini unutmayın. E-tablonun sahibi veya mevcut kullanıcı kaldırılamaz.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Removes the active user from the editors of the protected sheet.
sampleProtectedSheet.removeEditor(Session.getActiveUser());

// Gets the editors of the protected sheet.
const editors = sampleProtectedSheet.getEditors();

// Logs the editors' email addresses to the console.
for (const editor of editors) {
  console.log(editor.getEmail());
}

Parametreler

Ad	Tür	Açıklama
user	User	Kaldırılacak kullanıcının temsili.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

removeEditors(emailAddresses)

Belirtilen kullanıcı dizisini, korumalı sayfanın veya aralığın düzenleyiciler listesinden kaldırır. Kullanıcılardan herhangi biri düzenleme iznine sahip bir Google grubunun üyesiyse veya alan adındaki tüm kullanıcılar düzenleme iznine sahipse bu kullanıcıların, korumalı alanı düzenlemeye devam edebileceğini unutmayın. E-tablonun sahibi veya mevcut kullanıcı kaldırılamaz.

// Protect the active sheet, then remove all other users from the list of
// editors.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Parametreler

Ad	Tür	Açıklama
emailAddresses	String[]	Kaldırılacak kullanıcıların e-posta adresleri dizisi.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

removeTargetAudience(audienceId)

Belirtilen hedef kitleyi, korunan aralığın düzenleyicisi olarak kaldırır.

Parametreler

Ad	Tür	Açıklama
audienceId	String	Kaldırılacak hedef kitlenin kimliği.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setDescription(description)

Korunan aralığın veya sayfanın açıklamasını belirler.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the sheet 'Sheet1' by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet.
const sampleProtectedSheet = sheet.protect();

// Sets the sheet description to 'Sheet1 is protected.'
sampleProtectedSheet.setDescription('Sheet1 is protected');

// Gets the description of the protected sheet.
const sampleProtectedSheetDescription = sampleProtectedSheet.getDescription();

// Logs the description of the protected sheet to the console.
console.log(sampleProtectedSheetDescription);

Parametreler

Ad	Tür	Açıklama
description	String	Korunan aralığın veya sayfanın açıklaması.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setDomainEdit(editable)

E-tablonun sahibi olan alandaki tüm kullanıcıların, korumalı aralığı veya sayfayı düzenleme iznine sahip olup olmadığını belirler. Belirli düzenleme iznine sahip tüm kullanıcıların, bu ayardan bağımsız olarak korunan alanı düzenleyebileceğini unutmayın. E-tablo bir Google Workspace alanına ait değilse (yani bir gmail.com hesabına aitse) istisna oluşturur.

Parametreler

Ad	Tür	Açıklama
editable	Boolean	true, e-tablonun sahibi olan alandaki tüm kullanıcıların korunan aralığı veya sayfayı düzenleme iznine sahip olması gerektiğinde; false, aksi takdirde.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setNamedRange(namedRange)

Korunan aralığı mevcut bir adlandırılmış aralıkla ilişkilendirir. Adlandırılmış aralık, mevcut korumalı aralıktan farklı bir alanı kapsıyorsa bu yöntem, korumayı adlandırılmış aralığı kapsayacak şekilde taşır. Adlandırılmış aralık, mevcut korumalı aralıkla aynı sayfada olmalıdır. Komut dosyalarının, korumalı bir aralığı adlandırılmış bir aralıkla ilişkilendirmek için bu yöntemi açıkça çağırması gerektiğini unutmayın. setRangeName(rangeName) çağrılmadan, adlandırılmış bir Range aralığında koruma oluşturmak için Range.protect() çağrılması, bu aralıkları ilişkilendirmek için yeterli değildir. Ancak Google E-Tablolar kullanıcı arayüzünde adlandırılmış bir aralıktan korumalı aralık oluşturmak, bu aralıkları otomatik olarak ilişkilendirir.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Protects cells A1:D10 on Sheet1.
const sheet = ss.getSheetByName('Sheet1');
const protectedRange = sheet.getRange('A1:D10').protect();

// Logs the current protected range, A1:D10.
console.log(protectedRange.getRange().getA1Notation());

// Creates a named range for cells E1:J10 called 'NewRange.'
const newRange = sheet.getRange('E1:J10');
ss.setNamedRange('NewRange', newRange);
const namedRange = ss.getNamedRanges()[0];

// Updates the protected range to the named range, 'NewRange.'
// This updates the protected range on Sheet1 from A1:D10 to E1:J10.
protectedRange.setNamedRange(namedRange);

// Logs the updated protected range to the console.
console.log(protectedRange.getRange().getA1Notation());

Parametreler

Ad	Tür	Açıklama
namedRange	NamedRange	Korunan aralıkla ilişkilendirilecek mevcut adlandırılmış aralık.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setRange(range)

Korunan aralığı ayarlar. Belirtilen aralık, mevcut korumalı aralıktan farklı bir alanı kapsıyorsa bu yöntem, korumayı yeni aralığı kapsayacak şekilde taşır.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Protects cells A1:D10 on Sheet1 of the spreadsheet.
const sheet = ss.getSheetByName('Sheet1');
const protectedRange = sheet.getRange('A1:D10').protect();

// Logs the original protected range, A1:D10, to the console.
console.log(protectedRange.getRange().getA1Notation());

// Gets the range E1:J10.
const newRange = sheet.getRange('E1:J10');

// Updates the protected range to E1:J10.
protectedRange.setRange(newRange);

// Logs the updated protected range to the console.
console.log(protectedRange.getRange().getA1Notation());

Parametreler

Ad	Tür	Açıklama
range	Range	Düzenlemelerden korunacak yeni aralık.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setRangeName(rangeName)

Korunan aralığı mevcut bir adlandırılmış aralıkla ilişkilendirir. Adlandırılmış aralık, mevcut korumalı aralıktan farklı bir alanı kapsıyorsa bu yöntem, korumayı adlandırılmış aralığı kapsayacak şekilde taşır. Adlandırılmış aralık, mevcut korumalı aralıkla aynı sayfada olmalıdır. Komut dosyalarının, korumalı bir aralığı adlandırılmış bir aralıkla ilişkilendirmek için bu yöntemi açıkça çağırması gerektiğini unutmayın. setRangeName(rangeName) çağrılmadan, adlandırılmış bir Range aralığında koruma oluşturmak için Range.protect() çağrılması, bu aralıkları ilişkilendirmek için yeterli değildir. Ancak Google E-Tablolar kullanıcı arayüzünde adlandırılmış bir aralıktan korumalı aralık oluşturmak, bu aralıkları otomatik olarak ilişkilendirir.

// Protect a named range in a spreadsheet and log the name of the protected
// range.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const protection = range.protect();
ss.setNamedRange('Test', range);  // Create a named range.
protection.setRangeName(
    'Test');  // Associate the protection with the named range.
Logger.log(
    protection.getRangeName());  // Verify the name of the protected range.

Parametreler

Ad	Tür	Açıklama
rangeName	String	Korunacak adlandırılmış aralığın adı.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setUnprotectedRanges(ranges)

Korunan bir sayfadaki belirli aralık dizisinin korumasını kaldırır. Protection nesnesi korumalı bir sayfa yerine korumalı bir aralığa karşılık gelirse veya aralıklardan herhangi biri korumalı sayfada değilse istisna atar. Koruması kaldırılmış aralıkları değiştirmek için yeni bir aralık dizisi ayarlayın. Sayfanın tamamını yeniden korumak için boş bir dizi ayarlayın.

// Protect the active sheet except B2:C5, then remove all other users from the
// list of editors.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect().setDescription('Sample protected sheet');
const unprotected = sheet.getRange('B2:C5');
protection.setUnprotectedRanges([unprotected]);

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Parametreler

Ad	Tür	Açıklama
ranges	Range[]	Korunan bir sayfa içinde korumasız bırakılacak aralık dizisi.

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setWarningOnly(warningOnly)

Bu korumalı aralığın "uyarı tabanlı" koruma kullanıp kullanmadığını belirler. Uyarı tabanlı koruma, düzenleme işleminde kullanıcıdan düzenlemeyi onaylamasını isteyen bir uyarı gösterilmesi dışında, alandaki verileri her kullanıcının düzenleyebileceği anlamına gelir. Korunan aralıklar veya sayfalar varsayılan olarak uyarıya dayalı değildir. Uyarı durumunu kontrol etmek için isWarningOnly() simgesini kullanın.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets the sheet 'Sheet1' by its name.
const sheet = ss.getSheetByName('Sheet1');

// Protects the sheet and sets the protection to warning-based.
const sampleProtectedSheet = sheet.protect().setWarningOnly(true);

// Logs whether the protected sheet is warning-based to the console.
console.log(sampleProtectedSheet.isWarningOnly());

Parametreler

Ad	Tür	Açıklama
warningOnly	Boolean

Return

Protection: Zincirleme için koruma ayarlarını temsil eden nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets