Yetkilendirme Kapsamları

Kullanıcılar, verilerine erişen veya kendi adlarına işlem yapan komut dosyası projelerini yetkilendirmelidir. Kullanıcı, Kullanıcı arayüzünde yetkilendirme akışının başlatılması için bir istem gösterilir.

Bu akış sırasında kullanıcı arayüzü, kullanıcıya komut dosyasının ne için izin istediğini bildirir daha fazla bilgi edineceksiniz. Örneğin, bir komut dosyası kullanıcının kullanıcı etkinlikleri oluşturabilir veya bu kişilerin takvimlerinde etkinlik oluşturabilir. Komut dosyası projesi bu izinleri OAuth kapsamları olarak tanımlar.

Apps Komut Dosyası, çoğu komut dosyası için hangi kapsamların sizin için gerekli olanlar; bir komut dosyasının kullandığı kapsamları görüntüleyebilirsiniz istediğiniz zaman izleyebilirsiniz. Kapsamları açık bir şekilde de ayarlayabilirsiniz manifest'inizde URL dizeleri kullanın. Ayar kapsamlar bazen açık bir şekilde belirli uygulamalar için eklentilerden yararlanabilirsiniz. her zaman mümkün olan en dar kapsamları kullanın.

Apps Script, yetkilendirme akışı sırasında kullanıcıya gerekli kapsamların kullanıcı tarafından okunabilir açıklamalarını sunar. Örneğin, e-tablolarınıza salt okuma erişimi gerekiyorsa manifest dosyası, https://www.googleapis.com/auth/spreadsheets.readonly Etkinlik sırasında bu kapsama sahip bir komut dosyası, kullanıcıdan buna izin vermesini ister uygulamanızı "Google E-Tablolarınızı görüntüleyin" olarak değiştirin.

Bazı kapsamlar diğerlerini kapsar. Örneğin, kapsam yetkilendirildiğinde https://www.googleapis.com/auth/spreadsheets şunlara okuma ve yazma erişimi verir: elektronik tablolar.

Kapsamları görüntüleme

Şu anda komut dosyası projenizin gerektirdiği kapsamları takip etmek için:

  1. Komut dosyası projesini açın.
  2. Solda Genel bakış'ı tıklayın. .
  3. Kapsamları Proje OAuth Kapsamları bölümünde görüntüleyin.

Açık kapsamlar belirleme

Apps Komut Dosyası, bir komut dosyasının hangi kapsamlara ihtiyacı olduğunu otomatik olarak belirler çağrılarını gerektiren işlev çağrıları için kodunu tarayarak Çoğu komut dosyası için size zaman kazandırır ancak yayınlanan eklentiler için web'den uygulamaları, Google Chat uygulamaları ve Google Chat API çağrıları için daha fazla ve kapsamları doğrudan kontrol edebilmelisiniz.

Apps Komut Dosyası bazen projelere otomatik olarak çok izin verici kapsamlar atar. Bu, komut dosyanızın kullanıcıdan gereğinden fazlasını istediği anlamına gelebilir. Bu da kötü bir durumdur. alıştırma yapmak. Yayınlanan komut dosyaları için geniş kapsamları senaryonun ihtiyaçlarını karşılayan daha sınırlı bir gruptur.

Komut dosyası projenizin kullandığı kapsamları, manifest dosyasını düzenleyerek açıkça belirleyebilirsiniz. Manifest alanı oauthScopes, proje tarafından kullanılan tüm kapsamları içeren bir dizidir. Mevcut kapsamlarını değiştirmek üzere aşağıdakileri yapın:

  1. Komut dosyası projesini açın.
  2. Solda Proje Ayarları'nı tıklayın.
  3. Show "appsscript.json" dosyasını seçin. manifest dosyası düzenleyicide onay kutusunu işaretleyin.
  4. Sol kısımdan Düzenleyici'yi tıklayın.
  5. Soldaki appsscript.json dosyasını tıklayın.
  6. oauthScopes etiketli üst düzey alanı bulun. Bu seçenek yoksa ekleyebilirsiniz.
  7. oauthScopes alanı bir dize dizisi belirtir. Kapsamları ayarlamak için bu dizinin içeriğini, oluşturduğunuz kapsamlarla değiştirin bir şablondur. Ö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ı

Belirli OAuth kapsamları, Google'a erişime izin verdiği için hassastır Kullanıcı Verileri. Komut dosyası projenizde kullanıcı verilerine erişim sağlayan kapsamlar kullanılıyorsa ve gerekliliklere uygun olarak OAuth istemci doğrulaması önce herkese açık bir web uygulaması veya eklenti. 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ıtlanmış ve kullanıcı verilerinin korunmasına yardımcı olan ek kurallara tabidir. Şunu yapmayı amaçlıyorsanız: bir veya daha fazla tarayıcı kullanan bir web uygulaması ya da eklenti yayınlayın uygulamanın belirtilen tüm kısıtlamalara uyması gerekir üzerinde çalışır.

Kısıtlanmış kapsamların tam listesini inceleyin. inceleyin. Uygulamanızda bunlardan herhangi biri kullanılıyorsa politikaya uymanız gerekir şununla: Yayınlamadan önce, Belirli API kapsamları için Ek Gereksinimler