Yetkilendirme Kapsamları

Kullanıcıların, verilerine erişen veya üzerinde işlem yapan komut dosyası projelerini yetkilendirmesi gerekir anlamına gelir. 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 yardımcı oluyorum. Ö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.

Yetkilendirme akışı sırasında Apps Komut Dosyası, gerekli kapsamların açıklamalarına yer verir. Ö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ı ayarlama

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 çok geniş kapsamlı 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ı açıkça ayarlayabilir ve manifest dosyası olarak kaydedin. 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. Mevcut değilse bunu 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. Örnek: 
          {
        ...
        "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 kapsamlara ek olarak 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