Gmail

Gmail, Google'ın web tabanlı bir e-posta hizmetidir. Gmail bağlayıcısı ile e-posta iletileri gönderme veya alma gibi eylemler gerçekleştirebilir ve yeni e-postalarda akış tetikleyebilirsiniz.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Standart	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri :      - Azure Çin bölgeleri      - ABD Savunma Bakanlığı (DoD)
Power Apps	Standart	Aşağıdakiler dışında tüm Power Apps bölgeleri :      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Power Automate	Standart	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)

İletişim
İsim	Microsoft
URL	Microsoft LogicApps Desteği Microsoft Power Automate Desteği Microsoft Power Apps Desteği

Bağlayıcı Meta Verileri
Publisher	Microsoft
Web sitesi	https://mail.google.com/mail/
Gizlilik ilkesi	https://policies.google.com/privacy

Kimlik doğrulaması ve Kendi uygulamanızı getirme

Gmail bağlayıcısı artık birden çok kimlik doğrulama türünü destekliyor:

• Varsayılan paylaşılan uygulamayı kullanma
• Kendi uygulamanızı getirme

Varsayılan paylaşılan uygulama, Microsoft tarafından tutulan bir Google İstemci uygulaması kullanır. Bu durumda, Gmail hesabınızda oturum açtığınızda Microsoft Power Platform uygulamasını onaylamanız istenir.

"Kendi uygulamanızı getirin" seçeneğiyle, Microsoft tarafından yönetilen uygulama yerine kendi Google OAuth İstemci uygulamanızı kullanabilirsiniz. Bunu yapmak, izinleri denetlemenize ve bağlayıcı kullanımıyla ilgili belirli sınırlamaları etkinleştirmenize olanak tanır.

Gmail bağlayıcısı ile kendi Google OAuth İstemci uygulamanızı kullanmak için aşağıdaki adımları gerçekleştirmeniz gerekir:

1. Google'ın API Konsolunu kullanarak OAuth istemci uygulaması oluşturma
2. Gmail bağlayıcısında uygulamayı kullanma

Google'da OAuth İstemci Uygulaması Oluşturma

Kendi Google OAuth istemci uygulamanızı oluşturmak için önce üzerinde oturum açmanız https://developer.google.comgerekir. Google API'lerine erişimi yönetebileceğiniz Google API Konsolu'na gidin ve OAuth uygulamasını oluşturun. Bu işlem Google'ın Gmail API Geliştirici Kılavuzu'nda açıklanmıştır. Google, sizin için proje oluşturma, projeniz için Gmail API'sini etkinleştirme ve bir OAuth istemci uygulaması ile kimlik bilgileri oluşturma sürecinde size yol gösteren bir kurulum aracı sağlar. Aracı incelerken yararlı bulacağınız bazı bilgiler şunlardır:

• Gerekirse Hizmet Koşullarını okuyun ve kabul edin.
• Mevcut bir projeyi seçin, aksi takdirde araç "Projem" adlı yeni bir proje oluşturur.
• Araç, projede Gmail API'sini etkinleştirir.
• Araç, ihtiyacınız olan kimlik bilgisi türünü bulmaya çalışır. OAuth İstemcisi uygulaması almanız gerekir.
  • Kullanmakta olduğunuz API için Gmail API'sini seçin (henüz seçili değilse).
  • API'yi çağıracağın yer için Web sunucusu'nu seçin.
  • Eriştiğiniz veriler için Kullanıcı verileri'ni seçin.
• Araç, OAuth onayı ayarlama ekranında size yol gösterir.
  • Kullanıcı türünü (İç veya Dış) seçin. Gmail tüketici hesabı kullanıyorsanız dahili'yi seçemezsiniz.
  • Uygulamanız için bir ad ve isteğe bağlı olarak bir logo sağlayın.
  • Kapsam Ekle'ye tıklayın ve Gmail kapsamını (https://mail.google.com ekleyin).

    Uyarı

    Kullanım gereksinimlerinize bağlı olarak, burada izin kapsamlarının uygun bir alt kümesini seçebilirsiniz.

  • azure-apim.net yetkili etki alanlarından biri olarak ekleyin.

    Uyarı

    Bu, burada tanımlandığı gibi Gmail bağlayıcısının barındırıldığı etki alanıdır.

  • İsteğe bağlı olarak, diğer bilgileri sağlayın.
• Araç, OAuth 2.0 istemci kimlik bilgilerini tanımlamanıza ve eklemenize olanak verir.
  • OAuth İstemcisi uygulamanız için bir ad belirtin.
  • "; eklehttps://global.consent.azure-apim.net/redirect" yeniden yönlendirme URI'sini seçin.

İşiniz bittiğinde, Kimlik Bilgileri sayfasından oluşturulan OAuth istemcisine gidin. Uygulamanızın İstemci Kimliğini ve İstemci gizli dizisini bulursunuz. Artık bu değerleri Gmail bağlantınızda kullanabilirsiniz.

Gmail bağlayıcısında kendi uygulamanızı kullanma

Google OAuth istemci uygulamasını oluşturduktan sonra Gmail bağlantısı oluştururken kullanabilirsiniz.

• Kendi uygulamanızı getirin'i seçin.
• Uygulamanızdan İstemci Kimliği ve İstemci gizli anahtarı değerlerini belirtin.

Gmail hesabınızda oturum açmak için Oturum aç'a tıklayın. Bu işlem, Gmail hesabınızda oturum açmanızı ve ardından yukarıda oluşturduğunuz Google uygulamasına erişimi yetkilendirmenizi ister.

Bilinen sorunlar ve sınırlamalar

Çok sayıda gelen e-posta için tetikleyici sınırlamaları

Yeni bir e-posta geldiğinde tetikleyicisi, 30 saniyelik aralıkta 300'den fazla e-posta alıyorsanız e-postaları atlayabilir. E-posta sayısını azaltmak için akışınızı ek filtre parametreleriyle yapılandırmayı göz önünde bulundurun.

Google Workspace (eski adı G Suite) hesabı kullanıyorsanız Yeni bir e-posta geldiğinde tetikleyicisi, ekleri olan e-postaları aralıklı olarak atlayabilir. Bunun nedeni, bazı durumlarda Gmail API'sinin e-postaları işlemesinin uzun sürmesi (büyük olasılıkla eklerin güvenlik taramalarından kaynaklandığından), bu nedenle e-postaların belirli bir gecikmeyle alınmasıdır.

Olası geçici çözüm olarak lütfen aşağıdakileri deneyin:

• Küçük e-postalar kullanın (ekleri olmadan), bunları çok sık göndermemeye çalışın

• Başka bir tüketici Gmail hesabı kullanın ve Google Workspace hesabından bu yeni tüketici Gmail hesabına otomatik iletmeyi yapılandırın. Tetikleyiciyi bu yeni hesaba göre yapılandırın. Bu bir tüketici hesabı olduğundan, gecikmenin en aza indirileceğine ve tetikleyicinin bu tür e-postaları atlamayacağına inanıyoruz.

• ListMessage API'sine bir parametre ile özel bağlayıcıq kullanın:

  • Son 5 dakikadaki iletileri listelemek için bir eylem oluşturun. Parametresini kullanarak q bunu yapabilirsiniz. q Param değeri örneği - after:1649457986. Eylem girişi olarak dönem süresi sağlamanız current time - 5min gerekir.

    • 1649457986, "8 Nisan 2022 Cuma 15:46:26 GMT-07:00" öğesini temsil eden dönem zamanıdır.

  • Yanıt boş olana kadar yanıttan nextPageToken değerini denetleyin. Boş değilse, yanıttan nextPageToken olarak ayarlanmış parametre değeriyle pageToken aynı API'yi çağırmanız gerekir. Örneğin "Until" döngüsünü kullanarak bunu yapabilirsiniz.

  • Önceki çalıştırmalarda zaten işlenmiş olan bu ileti kimliklerini filtreleyin (örneğin, önceden işlenmiş kimlikleri depolamak için Azure Tablo Depolama bağlayıcısını kullanabilirsiniz)

  • Kimliğine göre e-posta içeriği almak için E-posta ayrıntılarını al eylemini kullanma

Gmail bağlayıcıyı tüketici Gmail hesaplarıyla kullanma

Google'ın güvenlik ve gizlilik ilkesine uygun olarak, tüketici Gmail hesaplarını kullanan müşteriler (Ile biten @gmail.com hesaplar ve @googlemail.com) yalnızca Power Automate ve Logic Apps içindeki sınırlı bir hizmet kümesine bağlanabilir. Google Workspace (eski adıyla G Suite) hesaplarını kullanan müşteriler bu değişiklikden etkilenmez. Gmail bağlayıcısını aşağıdaki listede belirtilmeyen hizmetlerle kullanmanız gerekiyorsa Kendi Uygulama kimliğinizi Google'a kaydetmeniz gerekir. Geçerli onaylanan hizmetlerin listesi aşağıdadır, bu listenin gelecekte Google'ın ilkelerine uygun olarak değişeceğini unutmayın:

• Google hizmetleri: Gmail, Google Takvim, Google Kişiler, Google Drive, Google E-Tablolar, Google Görevler
• Yerleşik eylemler ve tetikleyiciler: Denetim, AI Builder, Veri işlemleri, Tarih Saati, Sayı İşlevleri, Power Sanal Aracılar, Power Apps, İstek, Zamanlama, Metin İşlevleri, Değişkenler, Akış düğmesi, Konum
• Sınırlı sayıda Microsoft hizmeti: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP ve FTP

Uyumlu olmayan bir hizmetle akış oluşturursanız Power Automate'te akış devre dışı durumda kaydedilir.

İş birimlerini hesaplama

Bağlayıcının bir gün içinde tüketilebilen iş birimi sayısı için azaltma sınırı vardır ( buraya bakın).

Bu iş birimlerinin her işlem için nasıl hesaplandıklarına ilişkin mantık aşağıda gösterilmiştir:

• Yeni bir e-posta geldiğinde tetikleyici: 10 + (5 * attachmentsCount);
  • Tetikleyici yeni e-posta döndürürse: İletileri listelemek için 5 birim + ileti almak için 5 birim + 5 birim * ek sayısı.
  • Tetikleyici yeni e-posta döndürmezse: İletileri listelemek için 5 birim.
• E-posta gönder (V2) eylemi: 100 birim.
• E-postayı yanıtlama (V2) eylemi: 105 + (5 * attachmentsCount);
  • Özgün iletiyi almak için 5 birim + yanıt iletisi göndermek için 100 birim + 5 birim * satır içi ekler özgün iletide sayılır.
• Diğer tüm eylemler için: 10 birim.

Bağlayıcı derinlemesine

Bağlayıcı hakkında daha fazla bilgi için ayrıntılı bölüme bakın.

Genel Sınırlar

İsim	Değer
En büyük posta boyutu (MB cinsinden)	35
En büyük ek boyutu (MB cinsinden)	30

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Kendi uygulamanızı getirme	Kendi Google uygulamanızı kullanarak oturum açın. Diğer ayrıntılar için bkz: https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.	Tüm bölgeler	Paylaşılamaz
Varsayılan paylaşılan uygulamayı kullanma	Standart Google uygulamasını kullanarak oturum açın.	Tüm bölgeler	Paylaşılamaz
Varsayılan [KULLANIM DIŞI]	Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.	Tüm bölgeler	Paylaşılamaz

Kendi uygulamanızı getirme

Kimlik Doğrulama Kimliği: byoa

Geçerli: Tüm bölgeler

Kendi Google uygulamanızı kullanarak oturum açın. Diğer ayrıntılar için bkz: https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Müşteri Kimliği	String	Google uygulamanızın istemci (veya uygulama) kimliği	Doğru
İstemci Sırrı	securestring	Google uygulamanızın gizli anahtarı	Doğru

Varsayılan paylaşılan uygulamayı kullanma

Kimlik Doğrulama Kimliği: paylaşılan uygulama

Geçerli: Tüm bölgeler

Standart Google uygulamasını kullanarak oturum açın.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	60	60 saniye
Günlük iş birimleri	90000	86400 saniye

Eylemler

E-posta ayrıntılarını alma	Bu işlem belirli bir e-postanın ayrıntılarını alır.
E-posta gönder (V2)	Bu işlem, belirli alıcılara e-posta göndermek için kullanılır.
E-posta gönderme [KULLANIM DIŞI]	Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine E-posta gönder 'i (V2) kullanın. Bu işlem, belirli alıcılara e-posta göndermek için kullanılır.
E-postayı silme	Bu işlem belirli bir e-postayı kalıcı olarak silmek için kullanılır.
E-postayı yanıtlama (V2)	Bu işlem belirli bir e-postayı yanıtlamak için kullanılır.
E-postayı yanıtlama [KULLANIM DIŞI]	Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen E-postayı yanıtla (V2) kullanın. Bu işlem belirli bir e-postayı yanıtlamak için kullanılır.
E-postayı çöp kutusuna taşıma	Bu işlem, belirli bir e-postayı çöp kutusuna taşımak için kullanılır.

E-posta ayrıntılarını alma

İşlem Kimliği:

GetEmail

Bu işlem belirli bir e-postanın ayrıntılarını alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İleti Kimliği	id	True	string	E-posta iletisinin benzersiz kimliği.
Ekleri Ekle	includeAttachments		boolean	True olarak ayarlanırsa ekler de e-postayla birlikte alınır.

Döndürülenler

Belirli bir e-posta iletisiyle ilişkili ayrıntılar.

Body

DetailedReceiveMessage

E-posta gönder (V2)

İşlem Kimliği:

SendEmailV2

Bu işlem, belirli alıcılara e-posta göndermek için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İçin	To	True	email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
CC	Cc		email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
GİZLİ	Bcc		email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
Konu	Subject		string	Giden e-postanın konusu.
Body	Body		html	Giden e-postanın gövdesi.
Önemi	Importance		string	E-posta iletisiyle ilişkili önem derecesi.
İsim	Name	True	string	Ekin başlığı.
Content	ContentBytes	True	byte	Ekin gövdesi.
İçerik Türü	ContentType		string	Ekteki içerik türü.

E-posta gönderme [KULLANIM DIŞI]

İşlem Kimliği:

SendEmail

Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine E-posta gönder 'i (V2) kullanın.

Bu işlem, belirli alıcılara e-posta göndermek için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İçin	To	True	email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
CC	Cc		email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
GİZLİ	Bcc		email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
Konu	Subject		string	Giden e-postanın konusu.
Body	Body		string	Giden e-postanın gövdesi.
Is HTML	IsHtml		boolean	E-postayı HTML olarak göndermek için True. (varsayılan: True)
Önemi	Importance		string	E-posta iletisiyle ilişkili önem derecesi.
İsim	Name	True	string	Ekin başlığı.
Content	ContentBytes	True	byte	Ekin gövdesi.
İçerik Türü	ContentType		string	Ekteki içerik türü.

E-postayı silme

İşlem Kimliği:

DeleteEmail

Bu işlem belirli bir e-postayı kalıcı olarak silmek için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İleti Kimliği	id	True	string	Silinecek e-postanın kimliği.

E-postayı yanıtlama (V2)

İşlem Kimliği:

ReplyToV2

Bu işlem belirli bir e-postayı yanıtlamak için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İleti Kimliği	id	True	string	Yanıtladığınız e-postanın kimliği.
İçin	To		email	Örnek: recipient1@domain.com; recipient2@domain.com
CC	Cc		email	Örnek: recipient1@domain.com; recipient2@domain.com
GİZLİ	Bcc		email	Örnek: recipient1@domain.com; recipient2@domain.com
Konu	Subject		string	E-posta konusu (boşsa, kullanılan özgün konu).
Body	Body		html	E-postanın içeriği.
Tümünü Yanıtla	ReplyAll		boolean	Tüm alıcıları yanıtlamak için True. (varsayılan: False)
Önemi	Importance		string	Bir önem seçin. (varsayılan: Normal)
İsim	Name	True	string	Ekin başlığı.
Content	ContentBytes	True	byte	Ekin gövdesi.
İçerik Türü	ContentType		string	Ekteki içerik türü.

E-postayı yanıtlama [KULLANIM DIŞI]

İşlem Kimliği:

ReplyTo

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen E-postayı yanıtla (V2) kullanın.

Bu işlem belirli bir e-postayı yanıtlamak için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İleti Kimliği	id	True	string	Yanıtladığınız e-postanın kimliği.
İçin	To		email	Örnek: recipient1@domain.com; recipient2@domain.com
CC	Cc		email	Örnek: recipient1@domain.com; recipient2@domain.com
GİZLİ	Bcc		email	Örnek: recipient1@domain.com; recipient2@domain.com
Konu	Subject		string	E-posta konusu (boşsa, kullanılan özgün konu).
Body	Body		string	E-postanın içeriği.
Tümünü Yanıtla	ReplyAll		boolean	Tüm alıcıları yanıtlamak için True. (varsayılan: False)
Is HTML	IsHtml		boolean	Yanıtı HTML olarak göndermek için True. (varsayılan: True)
Önemi	Importance		string	Bir önem seçin. (varsayılan: Normal)
İsim	Name	True	string	Ekin başlığı.
Content	ContentBytes	True	byte	Ekin gövdesi.
İçerik Türü	ContentType		string	Ekteki içerik türü.

E-postayı çöp kutusuna taşıma

İşlem Kimliği:

TrashEmail

Bu işlem, belirli bir e-postayı çöp kutusuna taşımak için kullanılır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İleti Kimliği	id	True	string	Çöp kutusuna taşınacak e-postanın kimliği.

Tetikleyiciler

Yeni bir e-posta geldiğinde

Bu işlem, belirtilen ölçütlerle eşleşen yeni bir e-posta geldiğinde tetikler.

Yeni bir e-posta geldiğinde

İşlem Kimliği:

OnNewEmail

Bu işlem, belirtilen ölçütlerle eşleşen yeni bir e-posta geldiğinde tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Etiket	label		string	Bir etiket seçin (varsayılan: Gelen Kutusu).
İçin	to		email	Noktalı virgül veya virgülle ayrılmış geçerli e-posta adreslerinin listesi.
Kaynak	from		email	Örnek: Sender1 | sender2@domain.comöğesini seçin.
Konu	subject		string	Konu başlığında aranacak dize.
Önemi	importance		string	E-postanın önemli olması gerekiyorsa true. (varsayılan: Tümü).
Oynadı	starred		string	E-postanın yıldızlı olması gerekiyorsa true. (varsayılan: Tümü).
Ekleri Var	fetchOnlyWithAttachments		boolean	Yalnızca ekleri olan e-postaları almak için True.
Ekleri Ekle	includeAttachments		boolean	E-postayla birlikte ekleri almak için True.

Döndürülenler

Belirli bir e-posta iletisiyle ilişkili ayrıntılar.

Body

DetailedReceiveMessage

Tanımlar

DetailedReceiveMessage

Belirli bir e-posta iletisiyle ilişkili ayrıntılar.

Name	Yol	Tür	Description
Kaynak	From	email	İletinin gönderildiği e-posta adresi.
Gönderenin Adı	SenderName	string	E-posta gönderenin adı
İçin	To	email	İletinin gönderildiği e-posta adresi.
CC	Cc	email	Bilgi alanında bulunan e-posta adresleri.
GİZLİ	Bcc	email	Gizli alanında bulunan e-posta adresleri.
Konu	Subject	string	E-posta iletisiyle ilişkili konu veya konu.
Body	Body	string	E-posta iletisinin içeriği.
Parçacığını	Snippet	string	İleti metninin kısa bir bölümü.
Etiket Kimlikleri	LabelIds	array of string	E-posta iletisiyle ilişkili etiketlerin listesi.
Alınan Date-Time	DateTimeReceived	date-time	Örnek:2017-05-03T20:08:57+00:00
Tahmini Boyut	EstimatedSize	integer	İletinin bayt cinsinden tahmini boyutu.
Okundu mu?	IsRead	boolean	İleti okunursa True; false olarak ayarlayın.
Is HTML	IsHtml	boolean	İleti HTML biçimindeyse True.
Ekleri Var	HasAttachments	boolean	İletinin ekleri varsa true.
Attachments	Attachments	array of Attachment	E-posta iletisine eklerin listesi.
İleti Kimliği	Id	string	İletinin sabit kimliği.
İş Parçacığı Kimliği	ThreadId	string	İletinin ait olduğu iş parçacığının kimliği.

Ek

E-posta ekinin özellikleri.

Name	Yol	Tür	Description
İsim	Name	string	Ekin başlığı.
Content	ContentBytes	byte	Ekin gövdesi.
İçerik Türü	ContentType	string	Ekteki içerik türü.