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 eklentileri kullanarak 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:
- Komut dosyası projesini açın.
- Solda Genel bakış'ı tıklayın. .
- 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:
- Komut dosyası projesini açın.
- Solda Proje Ayarları'nı tıklayın.
- Show "appsscript.json" dosyasını seçin. manifest dosyası düzenleyicide onay kutusunu işaretleyin.
- Sol kısımdan Düzenleyici'yi tıklayın.
- Soldaki
appsscript.json
dosyasını tıklayın. oauthScopes
etiketli üst düzey alanı bulun. Mevcut değilse bunu ekleyebilirsiniz.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" ], ... }
- Ü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:
- Apps Komut Dosyası için OAuth istemci doğrulaması
- Doğrulanmamış uygulamalar
- OAuth doğrulamasıyla ilgili SSS
- Google API'leri Hizmeti: Kullanıcı Verileri Politikası
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