Aracılığıyla paylaş

X

Eski adı Twitter olan X, kullanıcıların kısa gönderiler gönderip almasını sağlayan çevrimiçi bir sosyal ağ hizmetidir. Gönderilerinizi yönetmek için X'e bağlanın. Gönderi gönderme, arama, takipçileri görüntüleme gibi çeşitli eylemler gerçekleştirebilirsiniz.

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 :
     - 21Vianet tarafından işletilen Çin Bulutu
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 :
     - 21Vianet tarafından işletilen Çin Bulutu
Power Automate Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - 21Vianet tarafından işletilen Çin Bulutu
İ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://x.com/
Gizlilik ilkesi https://x.com/privacy

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

Önemli

Varsayılan paylaşılan uygulama (Microsoft tarafından tutulan Twitter İstemci uygulaması) artık kullanılamaz. Bağlayıcı artık yalnızca bir kimlik doğrulama türünü destekliyor- Kendi uygulamanızı getirin. Haziran 2023 itibarıyla ücretli bir Kurumsal katman uygulaması gerekir. Ancak Twitter'ın fiyatlandırma ilkesi değişmeye devam edebilir.

"Kendi uygulamanızı getirin" seçeneğiyle kendi Twitter OAuth İstemci uygulamanızı kullanabilirsiniz. Bu, izinleri denetlemenize ve bağlayıcı kullanımıyla ilgili belirli sınırlamaları etkinleştirmenize olanak tanır.

Twitter bağlayıcısı ile kendi Twitter OAuth İstemcisi uygulamanızı kullanmak için aşağıdaki adımları uygulamanız gerekir:

  1. Twitter geliştirici sayfasını (https://developer.twitter.com) kullanarak OAuth istemci uygulaması oluşturma
  2. Uygulamayı Twitter bağlayıcısında kullanma

Twitter'da OAuth İstemci Uygulaması Oluşturma

Kendi Twitter OAuth istemci uygulamanızı oluşturmak için önce üzerinde https://developer.twitter.comoturum açmanız gerekir. Twitter uygulamalarını yönetebileceğiniz ve oluşturabileceğiniz "Projeler ve Uygulamalar" bölümüne gidin. Bu süreç Twitter'ın Twitter Geliştirici Kılavuzu'nda açıklanmıştır. Geliştirici sayfasında twitter uygulaması oluşturulduktan sonra düzgün kurulum için aşağıdaki adımlar gereklidir:

  • Twitter uygulamanızı seçin
  • Okuma ve yazma özelliklerini etkinleştirmek için uygulama izinlerini düzenleyin.
  • Kimlik doğrulama ayarlarını düzenleme
    • Üçüncü taraf kimlik doğrulamasını etkinleştirme
    • Geri çağırma URL'leri için ekleme https://global.consent.azure-apim.net/redirect (NOT: Fairfax aboneliği veya GCC ortamı kullanıyorsanız "Fairfax ve GCC geri çağırmaları" bölümüne bakın)
    • "Web Sitesi URL'si" değerini ayarlayın (gerekli alan, ancak değeri akışı etkilemez)

Fairfax ve GCC geri çağırmaları

Fairfax aboneliği veya GCC ortamı kullanıyorsanız Twitter uygulamanızın geri çağırma URL'leri için aşağıdaki URL'leri ekleyin:

  • Fairfax için:
    • https://logic-apis-usgovvirginia.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovtexas.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovarizona.consent.azure-apihub.us/redirect
  • GCC için:
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

İşiniz bittiğinde twitter uygulamanızı seçin ve "Anahtarlar ve belirteçler" sayfasına gidin. Uygulamanızın API anahtarını ve API anahtarı gizli dizisini almak için "Tüketici Anahtarları" bölümünde "Anahtarları Görüntüle" düğmesine tıklayın. Bu değerleri artık Twitter bağlantınızda kullanabilirsiniz.

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

Twitter OAuth istemci uygulamasını oluşturduktan sonra Twitter 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. (Twitter uygulamanızın API anahtarını ve API anahtar gizli dizisini kullanın)

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

SINIR -LARI

Sınırlar ve kısıtlamalardan bazıları şunlardır:

  1. Kullanıcı başına en fazla bağlantı sayısı: 2
  2. POST işlemi için API çağrı hızı sınırı: saatte 12
  3. Diğer işlemler için API çağrı hızı sınırı: saatte 600
  4. Tetikleyici yoklamalarının sıklığı: 1 saat
  5. En büyük görüntü yükleme boyutu: 5 MB
  6. Maksimum video yükleme boyutu: 15 MB
  7. En fazla arama sonucu sayısı: 100
  8. Bir yoklama aralığı içinde izlenen yeni tweet sayısı üst sınırı: 5
  9. İzin verilen en fazla 'Arama metni' parametre değeri uzunluğu 470'tir

Twitter API'sinin kısıtlamaları

  1. Arama API'sinde son 7 gün içinde yayımlanan son Tweetlerin örneklemesine göre arama
  2. Standart arama API'si ilgi düzeyine odaklanmıştır ve tamlığa odaklanmıştır. Bu, bazı Tweet'lerin ve kullanıcıların arama sonuçlarında eksik olabileceği anlamına gelir

POST işlemi için ek kısıtlamalar

Tweet gönderirken bir @user süre bahsedilmesi desteklenmez. Özellikle, tweet gönderirken "@" karakterleri kaldırılacaktır.

Genel Sınırlar

İsim Değer
Hesap başına bağlantı sayısı 2

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Kendi uygulamanızı getirme Kendi Twitter uygulamanızı kullanarak oturum açın. Daha fazla ayrıntı için bu sayfadaki 'Kimlik Doğrulaması ve Kendi uygulamanızı getirin' bölümüne bakı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 Twitter uygulamanızı kullanarak oturum açın. Daha fazla ayrıntı için bu sayfadaki 'Kimlik Doğrulaması ve Kendi uygulamanızı getirin' bölümüne bakı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.

İsim Türü Description Gerekli
Tüketici Anahtarı String Twitter uygulamanızın tüketici anahtarı Doğru
Tüketici Gizli Dizisi securestring Twitter uygulamanızın gizli dizisi Doğru

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.

Eylemler

Giriş zaman çizelgesini alma

Bu işlem, benim ve takipçilerim tarafından gönderilen en son tweet'leri ve yeniden tweet'leri alır.
Kullanıcı alma

Bu işlem kullanıcı adı, açıklama, takipçi sayısı ve daha fazlası gibi belirli bir kullanıcının profil ayrıntılarını alır.
Kullanıcı zaman çizelgesini alma

Bu işlem, belirli bir kullanıcı tarafından gönderilen en son tweetlerin listesini alır.
Retweet

Bu işlem bir tweet'i yeniden tweetler.
Takip edin

İşlem, verilen kullanıcının izlediği kişilerin listesini alır.
Takip edin

Bu işlem, takip ediyorum kullanıcıların listesini alır.
Takipçi alın

Bu işlem, belirli bir kullanıcıyı izleyen kullanıcıların listesini alır.
Takipçilerimi alın

Bu işlem, beni takip eden kullanıcıların listesini alır.
Tweet'leri arama

Bu işlem, arama sorgusuyla eşleşen ilgili tweetlerin listesini alır.
Tweet gönderme

Bu işlem yeni bir tweet gönderir.

Giriş zaman çizelgesini alma

İşlem Kimliği:
HomeTimeline

Bu işlem, benim ve takipçilerim tarafından gönderilen en son tweet'leri ve yeniden tweet'leri alır.

Parametreler

Name Anahtar Gerekli Tür Description
En fazla sonuç
 maxResults integer

Döndürülecek tweet sayısı üst sınırı.

Döndürülenler

response
array of TweetModel

Kullanıcı alma

İşlem Kimliği:
User

Bu işlem kullanıcı adı, açıklama, takipçi sayısı ve daha fazlası gibi belirli bir kullanıcının profil ayrıntılarını alır.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı adı
 userName True string

Kullanıcı için X tutamacı.

Döndürülenler

Bir kullanıcıyı temsil eder.

Body
UserDetailsModel

Kullanıcı zaman çizelgesini alma

İşlem Kimliği:
UserTimeline

Bu işlem, belirli bir kullanıcı tarafından gönderilen en son tweetlerin listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı adı
 userName True string

Kullanıcı için X tutamacı.
En fazla sonuç
 maxResults integer

Döndürülecek tweet sayısı üst sınırı.

Döndürülenler

response
array of TweetModel

Retweet

İşlem Kimliği:
Retweet

Bu işlem bir tweet'i yeniden tweetler.

Parametreler

Name Anahtar Gerekli Tür Description
Tweet kimliği
 tweetId True string

Retweetlenecek tweet'i seçin.
Kullanıcıyı kırp
 trimUser boolean

Kullanıcı bilgilerinin kırpılıp kırpılmayacağını belirten Boole değeri.

Döndürülenler

Tweet gönderisinin yanıtını temsil eder.

Body
TweetResponseModel

Takip edin

İşlem Kimliği:
Following

İşlem, verilen kullanıcının izlediği kişilerin listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı adı
 userName True string

Kullanıcı için X tutamacı.
En fazla sonuç
 maxResults integer

Döndürülecek en fazla kullanıcı sayısı.

Döndürülenler

response
array of UserDetailsModel

Takip edin

İşlem Kimliği:
MyFollowing

Bu işlem, takip ediyorum kullanıcıların listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
En fazla sonuç
 maxResults integer

Döndürülecek en fazla kullanıcı sayısı.

Döndürülenler

response
array of UserDetailsModel

Takipçi alın

İşlem Kimliği:
Followers

Bu işlem, belirli bir kullanıcıyı izleyen kullanıcıların listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı adı
 userName True string

Kullanıcı için X tutamacı.
En fazla sonuç
 maxResults integer

Döndürülecek en fazla kullanıcı sayısı.

Döndürülenler

response
array of UserDetailsModel

Takipçilerimi alın

İşlem Kimliği:
MyFollowers

Bu işlem, beni takip eden kullanıcıların listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
En fazla sonuç
 maxResults integer

Alınacak en fazla kullanıcı sayısı.

Döndürülenler

response
array of UserDetailsModel

Tweet'leri arama

İşlem Kimliği:
SearchTweet

Bu işlem, arama sorgusuyla eşleşen ilgili tweetlerin listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Arama metni
 searchQuery True string

"Happy hour", #haiku, from:@username, love OR hate gibi arama terimi.
En fazla sonuç
 maxResults integer

Döndürülecek tweet sayısı üst sınırı.
sinceId
 sinceId string

Belirtilen tweet kimliğinden sonra tweet'leri döndür.

Döndürülenler

response
array of TweetModel

Tweet gönderme

İşlem Kimliği:
Tweet

Bu işlem yeni bir tweet gönderir.

Parametreler

Name Anahtar Gerekli Tür Description
Tweet metni
 tweetText string

Postalanacak metin.
Medya
 body binary

Yayınlanacak medya.

Döndürülenler

Tweet gönderisinin yanıtını temsil eder.

Body
TweetResponseModel

Tetikleyiciler

Yeni bir tweet gönderildiğinde

Bu işlem, belirli bir arama sorgusuyla eşleşen yeni bir tweet gönderildiğinde bir akışı tetikler.

Yeni bir tweet gönderildiğinde

İşlem Kimliği:
OnNewTweet

Bu işlem, belirli bir arama sorgusuyla eşleşen yeni bir tweet gönderildiğinde bir akışı tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Arama metni
 searchQuery True string

"Happy hour", #haiku, from:@username, love OR hate gibi arama terimi.

Döndürülenler

Toplu tetikleyici yanıtı için sarmalayıcı nesnesini temsil eder

Body
TriggerBatchResponse[TweetModel]

Tanımlar

TweetModel

Bir tweet gönderisi temsil eder.

Name Yol Tür Description
Tweet metni
 TweetText string

Tweetin metin içeriği
Tweet kimliği
 TweetId string

Tweetin kimliği
Oluşturma saati:
 CreatedAtIso string

Tweetin gönderildiği saat
Retweet sayısı
 RetweetCount integer

Tweet için toplam yeniden tweet sayısı
Tweet'i oluşturan
 TweetedBy string

Tweeti gönderen kullanıcının adı
Medya url'leri
 MediaUrls array of string

Tweet ile birlikte gönderilen medyanın URL'si
Tweet dili
 TweetLanguageCode string

Tweetin dil kodu
in_reply_to_user_id
 TweetInReplyToUserId string

Geçerli tweetin yanıt olduğu tweetin yazarının kullanıcı kimliği
Sık Kullanılanlar
 Favorited boolean

Tweetin sık kullanılan olarak işaretlenip işaretlenmediğini gösterir
Kullanıcı bahsetmeleri
 UserMentions array of UserMentionsModel

Tweet'te bahsedilen kullanıcıların listesi
OriginalTweet
 OriginalTweet OriginalTweetModel

Özgün tweet gönderilerini temsil eder.
Kullanıcı Ayrıntıları
 UserDetails UserDetailsModel

Bir kullanıcıyı temsil eder.

UserMentionsModel

Tweet'te bahsedilen bir kullanıcıyı temsil eder.

Name Yol Tür Description
Bahsedilen kullanıcı kimliği
 Id integer

Kullanıcının X kimliği (tanıtıcı)
Bahsedilen kullanıcının tam adı
 FullName string

Kullanıcının tam adı
Bahsedilen kullanıcı adı
 UserName string

Kullanıcının ekran adı

OriginalTweetModel

Özgün tweet gönderilerini temsil eder.

Name Yol Tür Description
Özgün tweet metni
 TweetText string

Özgün alınan tweetin metin içeriği
Özgün tweet kimliği
 TweetId string

Özgün tweetin kimliği
Özgün tweet oluşturulduğu yer:
 CreatedAtIso string

Özgün tweet'in gönderilme zamanı
Özgün tweet retweet sayısı
 RetweetCount integer

Bu özgün tweet için toplam yeniden tweet sayısı
Tweet'in tweetlediği özgün tweet
 TweetedBy string

Özgün tweeti gönderen kişinin kullanıcı adı
Özgün tweet medya url'leri
 MediaUrls array of string

Özgün tweet ile birlikte gönderilen medyanın URL'si
Özgün tweet dili
 TweetLanguageCode string

Özgün tweet için dil kodu
Özgün tweet in_reply_to_user_id
 TweetInReplyToUserId string

Geçerli özgün tweetin yanıt olduğu tweetin yazarının kullanıcı kimliği
Sık kullanılan özgün tweet
 Favorited boolean

Özgün tweetin sık kullanılan olarak işaretlenip işaretlenmediğini gösterir
Özgün tweet kullanıcı bahsetmeleri
 UserMentions array of OriginalTweetUserMentionsModel

Tweet'te bahsedilen kullanıcının listesi
Kullanıcı Ayrıntıları
 UserDetails OriginalTweetUserDetailsModel

Özgün tweet gönderen kullanıcıyı temsil eder

UserDetailsModel

Bir kullanıcıyı temsil eder.

Name Yol Tür Description
İsim
 FullName string

Kullanıcının adı
Yer
 Location string

Kullanıcının konumu
Kullanıcı kimliği
 Id integer

Kullanıcının X kimliği (tanıtıcı)
Kullanıcı adı
 UserName string

Kullanıcının ekran adı
Takipçi sayısı
 FollowersCount integer

Takipçi sayısı
Description
 Description string

Kullanıcı açıklaması
Durum sayısı
 StatusesCount integer

Kullanıcı durumu sayısı
Arkadaş sayısı
 FriendsCount integer

Arkadaş sayısı
Favori sayısı
 FavouritesCount integer

Kullanıcının sık kullanılan tweet sayısı
Profil görüntüsü URL'si
 ProfileImageUrl string

Profil görüntüsünün url'si

OriginalTweetUserMentionsModel

Özgün tweet'te bahsedilen bir kullanıcıyı temsil eder.

Name Yol Tür Description
Bahsedilen özgün tweet kullanıcı kimliği
 Id integer

Kullanıcının X kimliği (tanıtıcı)
Kullanıcının tam adından bahsedilen özgün tweet
 FullName string

Kullanıcının tam adı
Kullanıcı adından bahsedilen özgün tweet
 UserName string

Kullanıcının ekran adı

OriginalTweetUserDetailsModel

Özgün tweet gönderen kullanıcıyı temsil eder

Name Yol Tür Description
Özgün tweet kullanıcı tam adı
 FullName string

Kullanıcının adı
Özgün tweet kullanıcısı Konumu
 Location string

Kullanıcının konumu
Özgün tweet kullanıcı kimliği
 Id integer

Kullanıcının X kimliği (tanıtıcı)
Özgün tweet kullanıcı adı
 UserName string

Kullanıcının ekran adı
Orijinal tweet kullanıcısı takipçi sayısı
 FollowersCount integer

Takipçi sayısı
Özgün tweet kullanıcısı Açıklaması
 Description string

Kullanıcı açıklaması
Özgün tweet kullanıcı durumlarının sayısı
 StatusesCount integer

Kullanıcı durumu sayısı
Özgün tweet kullanıcısı arkadaş sayısı
 FriendsCount integer

Arkadaş sayısı
Orijinal tweet kullanıcı favori sayısı
 FavouritesCount integer

Kullanıcının sık kullanılan tweet sayısı
Özgün tweet kullanıcı profili resim URL'si
 ProfileImageUrl string

Profil görüntüsünün url'si

TweetResponseModel

Tweet gönderisinin yanıtını temsil eder.

Name Yol Tür Description
Tweet kimliği
 TweetId string

Gönderilen tweetin kimliği

TriggerBatchResponse[TweetModel]

Toplu tetikleyici yanıtı için sarmalayıcı nesnesini temsil eder

Name Yol Tür Description
value
 value array of TweetModel

Yanıt nesnelerinin listesi