다음을 통해 공유

X

이전에 Twitter로 알려진 X는 사용자가 짧은 게시물을 보내고 받을 수 있는 온라인 소셜 네트워킹 서비스입니다. X에 연결하여 게시물을 관리합니다. 게시물 보내기, 검색, 팔로워 보기 등 다양한 작업을 수행할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 21Vianet에서 운영하는 중국 클라우드
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 21Vianet에서 운영하는 중국 클라우드
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 21Vianet에서 운영하는 중국 클라우드
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://x.com/
개인 정보 보호 정책 https://x.com/privacy

인증 및 사용자 고유의 애플리케이션 가져오기

중요합니다

기본 공유 애플리케이션(Microsoft에서 유지 관리하는 Twitter 클라이언트 애플리케이션)을 더 이상 사용할 수 없습니다. 이제 커넥터는 하나의 인증 유형(Bring Your Own Application)만 지원합니다. 2023년 6월부터 유료 엔터프라이즈 계층 애플리케이션이 필요합니다. 그러나 Twitter의 가격 책정 정책은 계속 변경될 수 있습니다.

"사용자 고유의 애플리케이션 가져오기" 옵션을 사용하면 사용자 고유의 Twitter OAuth 클라이언트 애플리케이션을 사용할 수 있습니다. 이렇게 하면 사용 권한을 제어하고 커넥터 사용에 대한 특정 제한을 사용하도록 설정할 수 있습니다.

Twitter 커넥터에서 사용자 고유의 Twitter OAuth 클라이언트 애플리케이션을 사용하려면 다음 단계를 수행해야 합니다.

  1. Twitter 개발자 페이지를 사용하여 OAuth 클라이언트 애플리케이션 만들기(https://developer.twitter.com)
  2. Twitter 커넥터에서 애플리케이션 사용

Twitter에서 OAuth 클라이언트 애플리케이션 만들기

자체 Twitter OAuth 클라이언트 애플리케이션을 만들려면 먼저 로그인해야 합니다 https://developer.twitter.com. Twitter 애플리케이션을 관리하고 만들 수 있는 "프로젝트 및 앱" 섹션으로 이동합니다. 이 프로세스는 Twitter의 Twitter 개발자 가이드에 설명되어 있습니다. 개발자 페이지에서 Twitter 앱을 만든 후에는 적절한 설치를 위해 다음 단계가 필요합니다.

  • Twitter 앱 선택
  • 앱 사용 권한을 편집하여 읽기 및 쓰기를 사용하도록 설정합니다.
  • 인증 설정 편집
    • 타사 인증 사용
    • 콜백 URL에 대한 추가 https://global.consent.azure-apim.net/redirect (참고: Fairfax 구독 또는 GCC 환경을 사용하는 경우 "Fairfax 및 GCC 콜백" 섹션 참조)
    • "웹 사이트 URL"(필수 필드이지만 값이 흐름에 영향을 주지 않음)을 설정합니다.

Fairfax 및 GCC 콜백

Fairfax 구독 또는 GCC 환경을 사용하는 경우 Twitter 앱의 콜백 URL에 대해 다음 URL을 추가합니다.

  • 페어팩스의 경우:
    • 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의 경우:
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

완료되면 Twitter 앱을 선택하고 "키 및 토큰" 페이지로 이동합니다. "소비자 키" 섹션에서 "키 보기" 단추를 클릭하여 앱의 API 키 및 API 키 비밀을 가져옵니다. 이제 Twitter 연결에서 해당 값을 사용할 수 있습니다.

Twitter 커넥터에서 사용자 고유의 애플리케이션 사용

Twitter OAuth 클라이언트 애플리케이션을 만든 후에는 Twitter 연결을 만드는 동안 사용할 수 있습니다.

  • 사용자 고유의 애플리케이션 가져오기를 선택합니다.
  • 애플리케이션에서 클라이언트 ID 및 클라이언트 비밀 값을 지정합니다. (Twitter 앱의 API 키 및 API 키 비밀 사용)

로그인을 클릭하여 Twitter 계정에 로그인합니다. 그러면 Twitter 계정에 로그인한 다음 위에서 만든 Twitter 앱에 대한 액세스 권한을 부여하라는 메시지가 표시됩니다.

제한

다음은 몇 가지 제한 사항입니다.

  1. 사용자당 최대 연결 수: 2
  2. POST 작업에 대한 API 호출 속도 제한: 시간당 12
  3. 다른 작업에 대한 API 호출 속도 제한: 시간당 600
  4. 트리거 폴링 빈도: 1시간
  5. 이미지 업로드의 최대 크기: 5MB
  6. 최대 비디오 업로드 크기: 15MB
  7. 최대 검색 결과 수: 100
  8. 한 폴링 간격 내에 추적된 새 트윗의 최대 수: 5
  9. 허용되는 최대 '텍스트 검색' 매개 변수 값 길이는 470입니다.

Twitter API의 제한 사항

  1. 검색 API는 지난 7일 동안 게시된 최근 트윗의 샘플링을 검색합니다.
  2. 표준 검색 API는 완전성이 아닌 관련성에 초점을 맞췄습니다. 즉, 일부 트윗과 사용자가 검색 결과에서 누락될 수 있습니다.

POST 작업에 대한 추가 제한 사항

트윗을 게시하는 @user 동안 언급하는 것은 지원되지 않습니다. 특히 트윗을 게시하는 동안 "@" 문자가 제거됩니다.

일반 제한

이름 가치
계정당 연결 2

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
사용자 고유의 애플리케이션 가져오기 사용자 고유의 Twitter 앱을 사용하여 로그인합니다. 자세한 내용은 이 페이지의 '인증 및 사용자 고유의 애플리케이션 가져오기' 섹션을 참조하세요. 모든 지역 공유할 수 없음
기본값 [사용되지 않음] 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. 모든 지역 공유할 수 없음

사용자 고유의 애플리케이션 가져오기

인증 ID: byoa

적용 가능: 모든 지역

사용자 고유의 Twitter 앱을 사용하여 로그인합니다. 자세한 내용은 이 페이지의 '인증 및 사용자 고유의 애플리케이션 가져오기' 섹션을 참조하세요.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
소비자 키 문자열 Twitter 애플리케이션의 소비자 키 진실
소비자 암호 시큐어스트링 (보안 문자열) Twitter 애플리케이션의 클라이언트 암호 진실

기본값 [사용되지 않음]

적용 가능: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

동작

내 다음 가져오기

이 작업은 내가 팔로우하는 사용자 목록을 가져옵니다.
내 팔로워 가져오기

이 작업은 나를 팔로우하는 사용자 목록을 가져옵니다.
다음 가져오기

이 작업은 지정된 사용자가 따르는 사용자 목록을 가져옵니다.
리트 윗

이 작업은 트윗을 리트윗합니다.
사용자 가져오기

이 작업은 사용자 이름, 설명, 팔로워 수 등 지정된 사용자에 대한 프로필 세부 정보를 가져옵니다.
사용자 타임라인 가져오기

이 작업은 지정된 사용자가 게시한 가장 최근의 트윗 목록을 가져옵니다.
트윗 검색

이 작업은 검색 쿼리와 일치하는 관련 트윗 목록을 가져옵니다.
트윗 게시

이 작업은 새 트윗을 게시합니다.
팔로워 가져오기

이 작업은 지정된 사용자를 따르는 사용자 목록을 가져옵니다.
홈 타임라인 가져오기

이 작업은 나와 내 추종자에 의해 게시 된 가장 최근의 트윗과 다시 트윗을 가져옵니다.

내 다음 가져오기

작업 ID:
MyFollowing

이 작업은 내가 팔로우하는 사용자 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
최대 결과
 maxResults integer

반환할 최대 사용자 수입니다.

반환

response
array of UserDetailsModel

내 팔로워 가져오기

작업 ID:
MyFollowers

이 작업은 나를 팔로우하는 사용자 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
최대 결과
 maxResults integer

가져올 최대 사용자 수입니다.

반환

response
array of UserDetailsModel

다음 가져오기

작업 ID:
Following

이 작업은 지정된 사용자가 따르는 사용자 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
사용자 이름
 userName True string

사용자에 대한 X 핸들입니다.
최대 결과
 maxResults integer

반환할 최대 사용자 수입니다.

반환

response
array of UserDetailsModel

리트 윗

작업 ID:
Retweet

이 작업은 트윗을 리트윗합니다.

매개 변수

Name 키 필수 형식 Description
트윗 ID
 tweetId True string

리트윗할 트윗입니다.
사용자 트리밍
 trimUser boolean

사용자 정보를 트리밍할지 여부를 나타내는 부울입니다.

반환

트윗 게시물의 응답을 나타냅니다.

몸
TweetResponseModel

사용자 가져오기

작업 ID:
User

이 작업은 사용자 이름, 설명, 팔로워 수 등 지정된 사용자에 대한 프로필 세부 정보를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
사용자 이름
 userName True string

사용자에 대한 X 핸들입니다.

반환

사용자를 나타냅니다.

몸
UserDetailsModel

사용자 타임라인 가져오기

작업 ID:
UserTimeline

이 작업은 지정된 사용자가 게시한 가장 최근의 트윗 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
사용자 이름
 userName True string

사용자에 대한 X 핸들입니다.
최대 결과
 maxResults integer

반환할 최대 트윗 수입니다.

반환

response
array of TweetModel

트윗 검색

작업 ID:
SearchTweet

이 작업은 검색 쿼리와 일치하는 관련 트윗 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
텍스트 검색
 searchQuery True string

"해피 아워", #haiku, from:@username, love 또는 hate와 같은 검색어입니다.
최대 결과
 maxResults integer

반환할 최대 트윗 수입니다.
sinceId
 sinceId string

지정된 트윗 ID 다음에 트윗을 반환합니다.

반환

response
array of TweetModel

트윗 게시

작업 ID:
Tweet

이 작업은 새 트윗을 게시합니다.

매개 변수

Name 키 필수 형식 Description
트윗 텍스트
 tweetText string

게시할 텍스트입니다.
미디어
 body binary

게시할 미디어입니다.

반환

트윗 게시물의 응답을 나타냅니다.

몸
TweetResponseModel

팔로워 가져오기

작업 ID:
Followers

이 작업은 지정된 사용자를 따르는 사용자 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
사용자 이름
 userName True string

사용자에 대한 X 핸들입니다.
최대 결과
 maxResults integer

반환할 최대 사용자 수입니다.

반환

response
array of UserDetailsModel

홈 타임라인 가져오기

작업 ID:
HomeTimeline

이 작업은 나와 내 추종자에 의해 게시 된 가장 최근의 트윗과 다시 트윗을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
최대 결과
 maxResults integer

반환할 최대 트윗 수입니다.

반환

response
array of TweetModel

트리거

새 트윗이 게시되는 경우

이 작업은 지정된 검색 쿼리와 일치하는 새 트윗이 게시될 때 흐름을 트리거합니다.

새 트윗이 게시되는 경우

작업 ID:
OnNewTweet

이 작업은 지정된 검색 쿼리와 일치하는 새 트윗이 게시될 때 흐름을 트리거합니다.

매개 변수

Name 키 필수 형식 Description
텍스트 검색
 searchQuery True string

"해피 아워", #haiku, from:@username, love 또는 hate와 같은 검색어입니다.

반환

일괄 처리 트리거 응답에 대한 래퍼 개체를 나타냅니다.

몸
TriggerBatchResponse[TweetModel]

정의

TweetModel

트윗 게시물을 나타냅니다.

Name 경로 형식 Description
트윗 텍스트
 TweetText string

트윗의 텍스트 콘텐츠
트윗 ID
 TweetId string

트윗의 ID
만든 시간
 CreatedAtIso string

트윗이 게시된 시간
리트윗 수
 RetweetCount integer

트윗의 총 재 트윗 수
트윗한 작성자
 TweetedBy string

트윗을 게시한 사용자의 이름
미디어 URL
 MediaUrls array of string

트윗과 함께 게시된 미디어의 URL
트윗 언어
 TweetLanguageCode string

트윗의 언어 코드
in_reply_to_user_id
 TweetInReplyToUserId string

현재 트윗이 회신인 트윗 작성자의 사용자 ID
즐겨찾기
 Favorited boolean

트윗이 즐겨찾기로 표시되는지 여부를 나타냅니다.
사용자 멘션
 UserMentions array of UserMentionsModel

트윗에 언급된 사용자 목록
OriginalTweet
 OriginalTweet OriginalTweetModel

원래 트윗 게시물을 나타냅니다.
사용자 세부 정보
 UserDetails UserDetailsModel

사용자를 나타냅니다.

UserMentionsModel

트윗에 언급된 사용자를 나타냅니다.

Name 경로 형식 Description
언급된 사용자 ID
 Id integer

사용자의 X ID(핸들)
언급된 사용자 전체 이름
 FullName string

사용자의 전체 이름
언급된 사용자 이름
 UserName string

사용자의 화면 이름

OriginalTweetModel

원래 트윗 게시물을 나타냅니다.

Name 경로 형식 Description
원래 트윗 텍스트
 TweetText string

원래 검색된 트윗의 텍스트 콘텐츠
원래 트윗 ID
 TweetId string

원래 트윗의 ID
에서 만든 원래 트윗
 CreatedAtIso string

원래 트윗이 게시된 시간
원래 트윗 리트윗 수
 RetweetCount integer

이 원래 트윗의 총 재 트윗 수
에 의해 트윗 원래 트윗
 TweetedBy string

원래 트윗을 게시한 사용자의 사용자 이름
원래 트윗 미디어 URL
 MediaUrls array of string

원본 트윗과 함께 게시된 미디어의 URL
원래 트윗 언어
 TweetLanguageCode string

원래 트윗의 언어 코드
원래 트윗 in_reply_to_user_id
 TweetInReplyToUserId string

현재 원래 트윗이 회신인 트윗 작성자의 사용자 ID
원래 트윗 즐겨찾기
 Favorited boolean

원래 트윗이 즐겨찾기로 표시되는지 여부를 나타냅니다.
원래 트윗 사용자 멘션
 UserMentions array of OriginalTweetUserMentionsModel

트윗에 언급된 사용자 목록
사용자 세부 정보
 UserDetails OriginalTweetUserDetailsModel

원래 트윗을 게시한 사용자를 나타냅니다.

UserDetailsModel

사용자를 나타냅니다.

Name 경로 형식 Description
이름
 FullName string

사용자의 이름
위치
 Location string

사용자의 위치
사용자 ID
 Id integer

사용자의 X ID(핸들)
사용자 이름
 UserName string

사용자의 화면 이름
팔로워 수
 FollowersCount integer

팔로워 수
Description
 Description string

사용자 설명
상태 수
 StatusesCount integer

사용자 상태 수
친구 수
 FriendsCount integer

친구 수
즐겨찾기 수
 FavouritesCount integer

사용자가 즐겨찾기한 트윗 수
프로필 이미지 URL
 ProfileImageUrl string

프로필 이미지의 URL

OriginalTweetUserMentionsModel

원래 트윗에 언급된 사용자를 나타냅니다.

Name 경로 형식 Description
원래 트윗에 언급된 사용자 ID
 Id integer

사용자의 X ID(핸들)
원래 트윗 언급 사용자 전체 이름
 FullName string

사용자의 전체 이름
원래 트윗에 언급된 사용자 이름
 UserName string

사용자의 화면 이름

OriginalTweetUserDetailsModel

원래 트윗을 게시한 사용자를 나타냅니다.

Name 경로 형식 Description
원래 트윗 사용자 전체 이름
 FullName string

사용자의 이름
원래 트윗 사용자 위치
 Location string

사용자의 위치
원래 트윗 사용자 ID
 Id integer

사용자의 X ID(핸들)
원래 트윗 사용자 이름
 UserName string

사용자의 화면 이름
원래 트윗 사용자 팔로워 수
 FollowersCount integer

팔로워 수
원래 트윗 사용자 설명
 Description string

사용자 설명
원래 트윗 사용자 상태 수
 StatusesCount integer

사용자 상태 수
원래 트윗 사용자 친구 수
 FriendsCount integer

친구 수
원래 트윗 사용자 즐겨찾기 수
 FavouritesCount integer

사용자가 즐겨찾기한 트윗 수
원래 트윗 사용자 프로필 이미지 URL
 ProfileImageUrl string

프로필 이미지의 URL

TweetResponseModel

트윗 게시물의 응답을 나타냅니다.

Name 경로 형식 Description
트윗 ID
 TweetId string

게시된 트윗의 ID

TriggerBatchResponse[TweetModel]

일괄 처리 트리거 응답에 대한 래퍼 개체를 나타냅니다.

Name 경로 형식 Description
value
 value array of TweetModel

응답 개체 목록