Yetkilendirme Kapsamları

Kullanıcıların, verilerine erişen veya kendi adlarına işlem yapan komut dosyası projelerini yetkilendirmesi gerekir. Bir kullanıcı ilk kez yetkilendirme gerektiren bir komut dosyasını çalıştırdığında, kullanıcı arayüzü yetkilendirme akışını başlatmak için bir istem sunar.

Bu akış sırasında kullanıcı arayüzü, kullanıcıya komut dosyasının ne yapmak için izin istediğini söyler. Örneğin, bir komut dosyası kullanıcının e-posta mesajlarını okuma veya takviminde etkinlik oluşturma izni isteyebilir. Komut dosyası projesi, bu izinleri ayrı ayrı OAuth kapsamları olarak tanımlar.

Apps Komut Dosyası, çoğu komut dosyası için hangi kapsamlara ihtiyaç duyulduğunu otomatik olarak algılar. Bir komut dosyasının kullandığı kapsamları istediğiniz zaman görüntüleyebilirsiniz. Ayrıca URL dizelerini kullanarak manifestinizde kapsamları açıkça ayarlayabilirsiniz. Yayınlanan uygulamaların her zaman mümkün olan en dar kapsamları kullanması gerektiğinden bazen eklentiler gibi belirli uygulamalar için kapsamların açıkça belirlenmesi gerekir.

Yetkilendirme akışı sırasında Apps Komut Dosyası, kullanıcıya gerekli kapsamların açıklamalarını sunar. Örneğin, komut dosyanızın e-tablolarınıza salt okuma erişimi gerekiyorsa manifest dosyası https://www.googleapis.com/auth/spreadsheets.readonly kapsamına sahip olabilir. Yetkilendirme akışı sırasında, bu kapsama sahip bir komut dosyası kullanıcıdan bu uygulamanın "Google E-Tablolarınızı görüntülemesi" için izin vermesini ister.

Bazı kapsamlar diğerlerini içerir. Örneğin, kapsam yetkilendirildiğinde https://www.googleapis.com/auth/spreadsheets, e-tablolar için okuma ve yazma erişimine izin verir.

Kapsamları görüntüleme

Aşağıdakileri yaparak komut dosyası projenizin şu anda gerektirdiği kapsamları görebilirsiniz:

  1. Komut dosyası projesini açın.
  2. Solda, Genel Bakış'ı tıklayın .
  3. Proje OAuth Kapsamları altındaki kapsamları görüntüleyin.

Açık kapsamları ayarlama

Apps Komut Dosyası, bir komut dosyasının kodunu onları gerektiren işlev çağrıları için tarayarak hangi kapsamlara ihtiyaç duyduğunu otomatik olarak belirler. Çoğu komut dosyası için bu yeterli olur ve size zaman kazandırır ancak yayınlanan eklentiler, web uygulamaları, Google Chat uygulamaları ve Google Chat API çağrıları için kapsamları daha doğrudan kontrol etmeniz gerekir.

Apps Komut Dosyası bazen projelere otomatik olarak son derece geniş kapsamlı kapsamlar atar. Bu, komut dosyanızın kullanıcıdan ihtiyaç duyduğundan fazlasını istediği anlamına gelebilir. Bu da kötü bir uygulamadır. Yayınlanan komut dosyaları için geniş kapsamları, komut dosyasının ihtiyaçlarını kapsayan ve daha fazlasını içermeyen daha sınırlı bir kümeyle değiştirmeniz gerekir.

manifest dosyasını düzenleyerek komut dosyası projenizin kullandığı kapsamları açıkça ayarlayabilirsiniz. Manifest alanı oauthScopes, proje tarafından kullanılan tüm kapsamları içeren bir dizidir. Projenizin kapsamlarını ayarlamak için aşağıdakileri yapın:

  1. Komut dosyası projesini açın.
  2. Solda Proje Ayarları'nı tıklayın.
  3. "appsscript.json" manifest dosyasını düzenleyicide göster onay kutusunu işaretleyin.
  4. Sol tarafta, Düzenleyici'yi tıklayın.
  5. Solda appsscript.json dosyasını tıklayın.
  6. oauthScopes etiketli en üst düzey alanı bulun. Ad yoksa ekleyebilirsiniz.
  7. oauthScopes alanı bir dize dizisi belirtir. Projenizin kullandığı kapsamları ayarlamak için bu dizinin içeriğini, kullanmasını istediğiniz kapsamlarla değiştirin. Örneğin: 
          {
        ...
        "oauthScopes": [
          "https://www.googleapis.com/auth/spreadsheets.readonly",
          "https://www.googleapis.com/auth/userinfo.email"
        ],
       ...
      }
  8. Üstte Kaydet'i tıklayın.

OAuth doğrulaması

Bazı OAuth kapsamları, Google Kullanıcı Verilerine erişim izni verdikleri için hassas niteliktedir. Komut dosyası projenizde kullanıcı verilerine erişim izni veren kapsamlar kullanılıyorsa projeyi bir web uygulaması veya eklenti olarak herkese açık şekilde yayınlayabilmeniz için projenin OAuth istemci doğrulamasından geçmesi gerekir. Daha fazla bilgi için aşağıdaki kılavuzlara bakın:

Kısıtlanmış kapsamlar

Hassas kapsamların yanı sıra belirli kapsamlar kısıtlı olarak sınıflandırılır ve kullanıcı verilerinin korunmasına yardımcı olan ek kurallara tabidir. Bir veya daha fazla kısıtlanmış kapsam kullanan bir web uygulaması veya eklenti yayınlamak istiyorsanız, uygulamanın yayınlanabilmesi için belirtilen tüm kısıtlamalara uyması gerekir.

Yayınlamadan önce kısıtlanmış kapsamların tam listesini inceleyin. Uygulamanız bunlardan herhangi birini kullanıyorsa yayınlamadan önce Belirli API kapsamları için Ek Şartlar'a uymanız gerekir.