Office 365 Grupları Postası

Office 365 Grupları Posta bağlayıcısı, kullanıcıların Office 365 Grubu posta kutusunda bulunan verilerle çalışmasını sağlar. Bu bağlayıcıdaki işlevsellik, tek bir kullanıcının kişisel posta kutusundan bağımsız olarak çalışır ve kullanıcıların kendi kuruluşlarında erişebilecekleri herhangi bir Grupla çalışmalarına olanak tanır. Bağlayıcı Microsoft Graph API'sinde çalışır ve Graph API'sindeki Office 365 Grupları belgelerinde belirtilen terminolojiyi kullanır. Bağlayıcı belgelerinde daha fazla bilgi edinin.

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

Hizmet	Class	Bölgeler
Copilot Studio	Standart	Tüm Power Automate bölgeleri
Logic Apps	Standart	Tüm Logic Apps bölgeleri
Power Apps	Standart	Tüm Power Apps bölgeleri
Power Automate	Standart	Tüm Power Automate bölgeleri

İ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://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Kategoriler	Verimli -lik

Önkoşullar

Bu bağlayıcıyı kullanmak için, bir kuruluştaki Office 365 Gruplarına erişimi olan bir kullanıcı hesabınız olmalıdır.

Verilerin API içinde nasıl yapılandırıldığını anlamak için Microsoft 365 Grupları için Microsoft Graph API Belgeleri'ni de gözden geçirmenizi öneririz. Bu bağlayıcıyı kullanmadan önce gözden geçirilmesi gereken "konuşma", "iş parçacığı" ve "gönderi" gibi önemli terminoloji vardır.

Bilinen Sorunlar ve Sınırlamalar

"Belirtilen nesne depoda bulunamadı" hatasını gidermek için aşağıdakileri yapabilirsiniz:

• Hesabın izinlerini doğrulayın.
• Geçerli Office 365 Grupları Posta bağlantısını silmeyi ve yeni bir tane oluşturmayı deneyin.

Üyelik olmadan "Genel" Gruplara erişme

Kimliği doğrulanmış bir kullanıcı, üyesi olduğu Gruplardan ve kuruluşundaki herhangi bir "Genel" Gruptan Grup verilerine erişebilir. Bağlayıcı deneyiminde, bir Grup seçerken bağlayıcı, aralarından seçim yapmak için gruplar'ın dinamik bir açılan listesini sunar. Daha temiz bir deneyim için bu açılan liste otomatik olarak yalnızca kimliği doğrulanmış kullanıcının üyesi olduğu Gruplar ile doldurulur.

Kuruluşunuzdaki açılan listede doldurulmayan "Genel" Gruplara erişmek için, en alta gidip Özel değer gir'i seçerek bağlayıcı açılan listesinde Grup Kimliğini sağlamanız gerekir.

Kuruluşunuzda bir Grup Kimliği bulmak için şu adımları izleyin:

1. Microsoft Graph Gezgini'ne gidin ve sol üst kısımda kullanıcınızla kimlik doğrulamasından geçin.

2. Örnek sorgular bölümünde Gruplar'ı ve ardından kuruluşumdaki tüm grupları AL'ı seçin.

3. Yanıt önizlemesinde, kuruluşunuzda aradığınız Grubu bulun. özelliğindeki id değeri bağlayıcı açılan deneyiminde özel değer olarak sağlayın.

4. Grup görünürlüğünün Genel olarak ayarlandığından emin olun, aksi takdirde kullanıcı Grup içindeki verilere erişemez.

5. Grubu bulamıyorsanız, bağlantıyı @odata.nextLink kopyalayıp sayfanın en üstünde sorgu olarak çalıştırarak erişilebilen bir sonraki sonuç sayfasına bakmanız gerekebilir.

Posta Tetikleyicileri

Aynı anda gönderilen çok sayıda e-posta varsa, bazı e-postalar tetikleyici tarafından kaçırılabilir. Bunun nedeni, e-postaların geç "görünür" hale gelmesine neden olan e-posta işleme gecikmeleriyle ilgili temel sistem sınırlamalarıdır (bağlayıcı geç e-postayı içeren toplu işlemi işledikten sonra).

Kullanımdan Kaldırma Bilgileri

Bu bağlayıcı için e-posta sızdırma denetimi desteğinin olmaması nedeniyle "Gönderiyi ilet" işlemi geçici olarak kullanım dışı bırakıldı. Destek sağlamak için çalışıyoruz ve tamamlandığında işlemi güncelleştireceğiz.

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	100	60 saniye
Tetikleyici yoklamalarının sıklığı	1	60 saniye

Eylemler

Grubun iş parçacıklarını listeleme	Bir grubun tüm iş parçacıklarını alma.
Grubun konuşmalarını listeleme	Bu gruptaki tüm konuşmaları alın.
Grup konuşması alma	Belirli bir konuşmanın özelliklerini alır.
Grupta yeni konuşma oluşturma	Bu grupta yeni bir konuşma oluşturun.
Gönderinin eklerini listeleme	Gönderiye ait eklerin listesini alın.
Gönderiyi iletme (Önizleme)	Gönderiyi alıcıya iletme.
Gönderiyi iletme [KULLANIM DIŞI]	Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Gönderiyi ilet'i kullanın. Gönderiyi alıcıya iletme.
Gönderiyi yanıtlama	Bir gönderiyi yanıtlayın ve grup konuşmasında belirtilen yazışmaya yeni bir gönderi ekleyin.
HTTP isteği gönderme	Çağırmak için bir Microsoft Graph REST API isteği oluşturun. Daha fazla bilgi edinin: https://docs.microsoft.com/en-us/graph/use-the-api
İş parçacığı gönderisi alma	Belirtilen iş parçacığındaki bir gönderiyi alır.
Konuşma yazışması alma	Bir gruba ait belirli bir iş parçacığını alın.
Konuşma yazışması oluşturma	Belirtilen konuşmada yeni bir iş parçacığı oluşturun.
Konuşma yazışması silme	Belirtilen konuşma yazışmasını siler.
Konuşma yazışmasını yanıtlama	Grup konuşmasında bir yazışmayı yanıtlayın ve buna yeni bir gönderi ekleyin.
Konuşma yazışmasının gönderilerini listeleme	Belirtilen konuşma yazışmasının tüm gönderilerini alın.
Konuşmanın konuşma yazışmalarını listeleme	Grup konuşmasında tüm yazışmaları alma.
Yazışma oluşturarak yeni bir grup konuşması başlatma	Önce bir yazışma oluşturarak yeni bir grup konuşması başlatın.

Grubun iş parçacıklarını listeleme

İşlem Kimliği:

ListGroupThreads

Bir grubun tüm iş parçacıklarını alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.

Döndürülenler

Name	Yol	Tür	Description
value	value	array of ConversationThread

Grubun konuşmalarını listeleme

İşlem Kimliği:

ListConversations

Bu gruptaki tüm konuşmaları alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.

Döndürülenler

Name	Yol	Tür	Description
value	value	array of Conversation

Grup konuşması alma

İşlem Kimliği:

GetGroupConversation

Belirli bir konuşmanın özelliklerini alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
Konuşma kimliği	conversationId	True	string	Konuşma kimliğini girin.

Döndürülenler

Konuşma nesnesi.

Body

Conversation

Grupta yeni konuşma oluşturma

İşlem Kimliği:

CreateConversation

Bu grupta yeni bir konuşma oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
Yeni konu	topic	True	string	Yeni konuşmanın konusu.
Content	content	True	html	Yeni konuşmanın içeriği.
Kategoriler	categories		array of string	Gönderiyle ilişkili kategoriler.
Adres	Address		email	E-posta adresi.
Ek adı	Name	True	string	Ekin adı.
Ek içeriği	ContentBytes	True	byte	Ekin içeriği.

Döndürülenler

Oluşturulan konuşma ayrıntılarıyla yanıtı.

Konuşma nesnesi oluşturuldu

CreateConversationResponse

Gönderinin eklerini listeleme

İşlem Kimliği:

GetAttachments

Gönderiye ait eklerin listesini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.
Posta Kimliği	postId	True	string	Posta kimliğini girin.

Döndürülenler

Name	Yol	Tür	Description
value	value	array of Attachment	Gönderinin eklerini içeren dizi.

Gönderiyi iletme (Önizleme)

İşlem Kimliği:

ForwardPost_V2

Gönderiyi alıcıya iletme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup postası	groupMail	True	string	Açılan listeden bir grup seçin veya grup posta adresini girin.
Konuşma kimliği	conversationId	True	string	Konuşma kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.
Posta Kimliği	postId	True	string	Posta kimliğini girin.
Comment	Comment		html	Gönderiyle birlikte iletecek açıklama.
Adres	Address		email	E-posta adresi.

Gönderiyi iletme [KULLANIM DIŞI]

İşlem Kimliği:

ForwardPost

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Gönderiyi ilet'i kullanın.

Gönderiyi alıcıya iletme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.
Posta Kimliği	postId	True	string	Posta kimliğini girin.
Comment	comment		string	Gönderiyle birlikte iletecek açıklama.
Adres	Address		email	E-posta adresi.

Gönderiyi yanıtlama

İşlem Kimliği:

ReplyPost

Bir gönderiyi yanıtlayın ve grup konuşmasında belirtilen yazışmaya yeni bir gönderi ekleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.
Posta Kimliği	postId	True	string	Posta kimliğini girin.
Content	content	True	html	Yeni konuşmanın içeriği.
Kategoriler	categories		array of string	Gönderiyle ilişkili kategoriler.
Adres	Address		email	E-posta adresi.
Ek adı	Name	True	string	Ekin adı.
Ek içeriği	ContentBytes	True	byte	Ekin içeriği.

HTTP isteği gönderme

İşlem Kimliği:

HttpRequest

Çağırmak için bir Microsoft Graph REST API isteği oluşturun. Daha fazla bilgi edinin: https://docs.microsoft.com/en-us/graph/use-the-api

Parametreler

Name	Anahtar	Gerekli	Tür	Description
URI	Uri	True	string	Tam veya göreli URI. Örnek: https://graph.microsoft.com/{version}/{resource}.
Yöntem	Method	True	string	HTTP yöntemi (varsayılan olarak GET'dir).
Body	Body		binary	İstek gövdesi içeriği.
İçerik Türü	ContentType		string	Gövde için içerik türü üst bilgisi (varsayılan değer application/json'dır).
CustomHeader1	CustomHeader1		string	Özel üst bilgi 1. Biçimde belirtin: üst bilgi-adı: header-value
CustomHeader2	CustomHeader2		string	Özel üst bilgi 2. Biçimde belirtin: üst bilgi-adı: header-value
CustomHeader3	CustomHeader3		string	Özel üst bilgi 3. Biçimde belirtin: üst bilgi-adı: header-value
CustomHeader4	CustomHeader4		string	Özel üst bilgi 4. Biçimde belirtin: üst bilgi-adı: header-value
CustomHeader5	CustomHeader5		string	Özel üst bilgi 5. Biçimde belirtin: üst bilgi-adı: header-value

Döndürülenler

response

ObjectWithoutType

İş parçacığı gönderisi alma

İşlem Kimliği:

GetThreadPost

Belirtilen iş parçacığındaki bir gönderiyi alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.
Posta Kimliği	postId	True	string	Posta kimliğini girin.

Döndürülenler

Bir conversationThread varlığındaki tek bir Post öğesini temsil eder.

Body

Post

Konuşma yazışması alma

İşlem Kimliği:

GetConversationThread

Bir gruba ait belirli bir iş parçacığını alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.

Döndürülenler

Konuşma iş parçacığı nesnesi.

Body

ConversationThread

Konuşma yazışması oluşturma

İşlem Kimliği:

CreateConversationThread

Belirtilen konuşmada yeni bir iş parçacığı oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
Konuşma kimliği	conversationId	True	string	Konuşma kimliğini girin.
Yeni konu	topic	True	string	Yeni konuşmanın konusu.
Content	content	True	html	Yeni konuşmanın içeriği.
Kategoriler	categories		array of string	Gönderiyle ilişkili kategoriler.
Adres	Address		email	E-posta adresi.
Ek adı	Name	True	string	Ekin adı.
Ek içeriği	ContentBytes	True	byte	Ekin içeriği.

Döndürülenler

Body

NewConversationThreadResponse

Konuşma yazışması silme

İşlem Kimliği:

DeleteConversationThread

Belirtilen konuşma yazışmasını siler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.

Konuşma yazışmasını yanıtlama

İşlem Kimliği:

ReplyToAThread

Grup konuşmasında bir yazışmayı yanıtlayın ve buna yeni bir gönderi ekleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.
Content	content	True	html	Yeni konuşmanın içeriği.
Kategoriler	categories		array of string	Gönderiyle ilişkili kategoriler.
Adres	Address		email	E-posta adresi.
Ek adı	Name	True	string	Ekin adı.
Ek içeriği	ContentBytes	True	byte	Ekin içeriği.

Konuşma yazışmasının gönderilerini listeleme

İşlem Kimliği:

ListThreadPosts

Belirtilen konuşma yazışmasının tüm gönderilerini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
İş Parçacığı Kimliği	threadId	True	string	Konuşma yazışması kimliğini girin.

Döndürülenler

Name	Yol	Tür	Description
value	value	array of Post	Belirtilen iş parçacığındaki gönderileri içeren dizi.

Konuşmanın konuşma yazışmalarını listeleme

İşlem Kimliği:

ListConversationThreads

Grup konuşmasında tüm yazışmaları alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
Konuşma kimliği	conversationId	True	string	Konuşma kimliğini girin.

Döndürülenler

Name	Yol	Tür	Description
value	value	array of ConversationThread

Yazışma oluşturarak yeni bir grup konuşması başlatma

İşlem Kimliği:

CreateGroupThread

Önce bir yazışma oluşturarak yeni bir grup konuşması başlatın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.
Yeni konu	topic	True	string	Yeni konuşmanın konusu.
Content	content	True	html	Yeni konuşmanın içeriği.
Kategoriler	categories		array of string	Gönderiyle ilişkili kategoriler.
Adres	Address		email	E-posta adresi.
Ek adı	Name	True	string	Ekin adı.
Ek içeriği	ContentBytes	True	byte	Ekin içeriği.

Döndürülenler

Body

NewConversationThreadResponse

Tetikleyiciler

Gruba yeni bir e-posta geldiğinde

Gruba yeni bir e-posta geldiğinde.

Gruba yeni bir e-posta geldiğinde

İşlem Kimliği:

OnNewEmailInGroup

Gruba yeni bir e-posta geldiğinde.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Grup Kimliği	groupId	True	string	Açılan listeden bir grup seçin veya grup kimliğini girin.

Döndürülenler

Name	Yol	Tür	Description
value	value	array of ConversationTriggerResponse	Tetikleyicinin yanıtı.

Tanımlar

Konuşma

Konuşma nesnesi.

Name	Yol	Tür	Description
Konuşma kimliği	id	string	Konuşmaların benzersiz tanımlayıcısı.
Konuşma konusu	topic	string	Konuşmanın konusu.
Ekleri var mı?	hasAttachments	boolean	Bu Konuşmadaki gönderilerden herhangi birinin en az bir eki olup olmadığını gösterir.
Son teslim edilen zaman damgası	lastDeliveredDateTime	date-time	Zaman damgası türü, ISO 8601 biçimini kullanan tarih ve saat bilgilerini temsil eder ve her zaman UTC saatindedir.
Benzersiz gönderenler dizisi	uniqueSenders	array of string	Bu Konuşmaya ileti gönderen tüm kullanıcılar.
Preview	preview	string	Bu Konuşmadaki en son gönderinin gövdesinden kısa bir özet.

ConversationThread

Konuşma iş parçacığı nesnesi.

Name	Yol	Tür	Description
Konuşma yazışması kimliği	id	string	Konuşma yazışmasının benzersiz tanımlayıcısı.
Konuşma konusu	topic	string	Konuşmanın konusu.
Ekleri var mı?	hasAttachments	boolean	Bu Konuşmadaki gönderilerden herhangi birinin en az bir eki olup olmadığını gösterir.
Son teslim edilen zaman damgası	lastDeliveredDateTime	date-time	Zaman damgası türü, ISO 8601 biçimini kullanan tarih ve saat bilgilerini temsil eder ve her zaman UTC saatindedir.
Benzersiz gönderenler dizisi	uniqueSenders	array of string	Bu Konuşmaya ileti gönderen tüm kullanıcılar.
Preview	preview	string	Bu Konuşmadaki en son gönderinin gövdesinden kısa bir özet.
Kilitli mi?	isLocked	boolean	İş parçacığının kilitli olup olmadığını gösterir.
toRecipients	toRecipients	array of EmailAddress	İş parçacığı için Alıcı: alıcıları.
ccRecipients	ccRecipients	array of EmailAddress	İş parçacığının Bilgi: alıcıları.

Gönderi

Bir conversationThread varlığındaki tek bir Post öğesini temsil eder.

Name	Yol	Tür	Description
Posta Kimliği	id	string	Gönderinin benzersiz tanımlayıcısı.
Gönderinin zaman damgası oluşturuldu	createdDateTime	date-time
Gönderinin son değiştirilen zaman damgası	lastModifiedDateTime	date-time
Anahtarı Değiştir	changeKey	string	Gönderinin sürümünü tanımlar.
Konuşma kimliği	conversationId	string	Gönderinin ait olduğu konuşmanın benzersiz kimliği.
Konuşma yazışması kimliği	conversationThreadId	string	Gönderinin ait olduğu konuşma yazışmasının benzersiz kimliği.
Kategoriler	categories	array of string	Gönderiyle ilişkili kategoriler.
Alınan zaman damgası	receivedDateTime	date-time	Alınan zaman damgasını sonrası.
Ekleri var mı?	hasAttachments	boolean	Gönderinin en az bir eki olup olmadığını gösterir.
Yeni katılımcılar	newParticipants	array of EmailAddress	Bu gönderinin bir parçası olarak yazışmaya eklenen konuşma katılımcıları.
body	body	ItemBody	İleti, olay veya grup gönderisi gibi bir öğenin gövdesinin özelliklerini temsil eder.
itibaren	from	EmailAddress
gönderen	sender	EmailAddress
attachments	attachments	array of Attachment

Ek

Name	Yol	Tür	Description
Ek Kimliği	id	string	Ekin kimliği.
Ek adı	name	string	Ekin adı.
Ek içerik Türü	contentType	string	Ekin içerik türü.
Ek dosya boyutu	size	integer	Ekin boyutu.
Ek içerik baytları	contentBytes	byte	Ekin içeriği.

E-posta Adresi

Name	Yol	Tür	Description
Kullanıcının adı	emailAddress.name	string
Kullanıcının e-posta adresi	emailAddress.address	email

Öğe Gövdesi

İleti, olay veya grup gönderisi gibi bir öğenin gövdesinin özelliklerini temsil eder.

Name	Yol	Tür	Description
Gövde içerik türü	contentType	string	Gövdenin içerik türü.
Gövde içeriği	content	string	Gövdenin içeriği.

CreateConversationResponse

Oluşturulan konuşma ayrıntılarıyla yanıtı.

Name	Yol	Tür	Description
Konuşma kimliği	id	string	Yeni Konuşma Kimliği.
Konuşma yazışmaları	threads	array of object	Konuşma yazışması oluşturuldu.
İş Parçacığı Kimliği	threads.id	string	Yeni iş parçacığı kimliği.

NewConversationThreadResponse

Name	Yol	Tür	Description
Konuşma yazışması kimliği	id	string	Yeni konuşma yazışması kimliği.

ConversationTriggerResponse

Yeni bir e-posta geldiğinde tetikleyici yanıtı.

Name	Yol	Tür	Description
Konuşma kimliği	id	string	Konuşma benzersiz tanımlayıcısı.
Son teslim edilen zaman damgası	lastDeliveredDateTime	date-time	Zaman damgası türü, ISO 8601 biçimini kullanan tarih ve saat bilgilerini temsil eder ve her zaman UTC saatindedir.
threads	threads	array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Konuşma iş parçacığı nesnesi.

Name	Yol	Tür	Description
Konuşma yazışması kimliği	id	string	Konuşma yazışmasının benzersiz tanımlayıcısı.
Mesaj	posts	array of PostTriggerResponse

PostTriggerResponse

Bir conversationThread varlığındaki tek bir Post öğesini temsil eder.

Name	Yol	Tür	Description
Posta Kimliği	id	string	Gönderinin benzersiz tanımlayıcısı.
Gönderinin son değiştirilen zaman damgası	lastModifiedDateTime	date-time
Anahtarı Değiştir	changeKey	string	Gönderinin sürümünü tanımlar.

ObjectWithoutType