다음을 통해 공유

Office 365 사용자

Office 365 사용자 연결 공급자를 사용하면 Office 365 계정을 사용하여 조직의 사용자 프로필에 액세스할 수 있습니다. 프로필, 사용자 프로필, 사용자의 관리자 또는 직접 보고서 가져오기와 같은 다양한 작업을 수행하고 사용자 프로필을 업데이트할 수도 있습니다.

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

서비스 클래스 Regions
Copilot Studio 스탠다드 모든 Power Automate 지역
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps 스탠다드 모든 Power Apps 지역
Power Automate 스탠다드 모든 Power Automate 지역
연락처
이름 Office 365 사용자
URL https://learn.microsoft.com/en-us/connectors/office365users/
전자 메일 idcknowledgeeco@microsoft.com
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://www.office.com/
개인 정보 보호 정책 https://privacy.microsoft.com/
카테고리 AI; 비즈니스 인텔리전스

Power Apps에서 이 커넥터를 사용하려면 여기에서 자세히 알아보세요.

알려진 문제 및 제한 사항

다음은 Office 365 사용자 커넥터 사용의 알려진 제한 사항 중 일부입니다.

  1. 이 통합을 사용하려면 REST API를 사용하도록 설정된 Office 365 사서함에 액세스해야 합니다. 연결을 만들려면 로그인을 선택합니다. Office 365 계정을 제공하고 화면의 나머지 부분에 따라 연결을 만들라는 메시지가 표시됩니다.
  2. 커넥터는 LogicApps 미국 정부 클라우드의 GCCH(Government Community Cloud High) 계정을 지원하지 않습니다.
  3. 커넥터를 사용하는 동안 오류가 표시되면 REST API가 사용하도록 설정되어 있는지 확인하세요. 전용(온-프레미스) 메일 서버의 계정 또는 샌드박스(테스트) 계정인 계정에서도 오류가 표시 될 수 있습니다. 관리자는 여기에서 사서함을 마이그레이션하는 방법을 알아볼 수 있습니다. 또한 EWS 애플리케이션 액세스 정책을 사용하는 경우 다음 사용자 에이전트가 허용되는지 확인하세요. "LogicAppsDesigner/*","azure-logic-apps/*","PowerApps/*", "Mozilla/*"
  4. 관리자 가져오기(V2) 작업은 "지정된 사용자에 대한 관리자를 찾을 수 없음"을 반환합니다.
    • 이 문제는 사용자에게 Microsoft Entra ID에 구성된 관리자가 없는 경우에 발생합니다. 여기에서 관리자를 구성하도록 Microsoft Entra ID 사용자의 프로필을 업데이트하는 방법을 알아봅니 다.
  5. 직접 보고서 가져오기(V2), 관리자 가져오기(V2), 내 프로필 가져오기(V2) 및 사용자 프로필 가져오기(V2) 작업은 입력 매개 변수 Select fields를 선언합니다. 이 매개 변수에서 선택할 혼수 상태로 구분된 필드 목록을 지정할 수 있습니다(여기에서 사용 가능한 필드에 대한 자세한 정보). 예를 들어:
    • department, jobTitle
    • displayName, surname, mailNickname, userPrincipalName
  6. 매개 변수를 지정하지 않으면 기본적으로 다음 필드가 선택됩니다. aboutMe, accountEnabled, birthday, businessPhones, city, companyName, country, department, displayName, givenName, hireDate, id, interests, jobTitle, mail, mailNickname, mobilePhone, mySite, officeLocation, pastProjects, postalCode, preferredLanguage, preferredName, responsibilities, schools, skills, state, streetAddress, surname, userPrincipalName, userType.
  7. 위에 설명된 대로 기본적으로 선택한 필드 중 일부가 테넌트 정책에 의해 차단되는 경우 직접 보고서 가져오기(V2), 관리자 가져오기(V2), 내 프로필 가져오기(V2) 및 사용자 프로필 가져오기(V2) 작업이 실패 403 Forbidden 할 수 있습니다. 필드를 허용 목록에 추가하려면 테넌트 관리자에게 문의하거나 매개 변수를 Select fields 명시적으로 지정해 보세요.
    • 외부 사용자를 제외한 모든 사용자가 위에서 설명한 대로 기본적으로 선택된 필드를 쿼리하기 My Site Host 위해 SharePoint 관리 센터의 "내 설정" 및 "사용 권한" 섹션 모두에 대한 사용 권한이 있는지 확인합니다.
  8. 조건부 액세스 정책은 커넥터가 예상대로 실행되지 않도록 할 수 있습니다. 오류의 예: "AADSTS53003: 조건부 액세스 정책에 의해 액세스가 차단되었습니다. 액세스 정책은 토큰 발급을 허용하지 않습니다.". 자세한 내용은 Microsoft Entra ID 조건부 액세스 설명서를 참조하세요.
  9. 게스트 사용자가 사용하는 경우 내 프로필 가져오기(V2) 작업이 오류로 401 Unauthorized 인해 실패할 수 있습니다. 이를 해결하려면 다음을 위해 매개 변수를 Select fields 명시적으로 지정해 id, displayName, givenName, surname, mail, mailNickname, accountEnabled, userPrincipalName, department, jobTitle, mobilePhone, businessPhones, city, companyName, country, officeLocation, postalCode보세요.
  10. SearchUser(v2) 가 오류로 실패 403 Insufficient privileges to complete the operation 할 수 있습니다.
    • 게스트 사용자는 의도적으로 제한됩니다. 다른 제안 사항은 SharePoint의 Office365 사용자 목록으로 채워진 사용자 목록을 만든 다음 이 목록을 데이터 원본으로 사용하는 것입니다.
    • 또한 게스트의 액세스 권한을 제한하면 조직의 정보 보안을 강화할 수 있습니다. 이 작업의 보안 영향을 평가하는 것이 좋습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

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

제한 한도

Name 호출 갱신 기간
연결당 API 호출 1000 60초

동작

HTTP 요청 보내기

호출할 Microsoft Graph REST API 요청을 생성합니다. 이러한 세그먼트는 지원됩니다. 첫 번째 세그먼트: /me, /users/<userId> 2번째 세그먼트: 메시지, mailFolders, 이벤트, 일정, 일정, outlook, inferenceClassification. https://docs.microsoft.com/en-us/graph/use-the-api에서 자세한 내용을 알아보세요.
관련 사용자 가져오기

관련 사용자를 가져옵니다.
관리자 가져오기(V1) [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 Get 관리자(V2) 를 사용하세요.

지정된 사용자 관리자의 프로필을 검색합니다.
관리자 가져오기(V2)

지정된 사용자 관리자의 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
내 프로필 가져오기(V1) [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 내 프로필 가져오기(V2)를 사용하세요.

현재 사용자의 프로필을 검색합니다.
내 프로필 가져오기(V2)

현재 사용자의 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
내 프로필 사진 업데이트

현재 사용자의 프로필 사진을 업데이트합니다. 사진 크기는 4MB 미만이어야 합니다.
내 프로필 업데이트

현재 사용자의 프로필을 업데이트합니다.
사용자 검색(V2)

검색어(V2)와 일치하는 사용자 프로필을 검색합니다.
사용자 검색 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 사용자 검색(V2) 을 사용하세요.

검색 용어와 일치하는 사용자 프로필을 검색합니다.
사용자 사진 가져오기(V1) [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 사용자 사진 가져오기(V2) 를 사용하세요.

지정된 사용자의 사진이 있는 경우 해당 사용자의 사진을 검색합니다.
사용자 사진 가져오기(V2)

지정된 사용자의 사진이 있는 경우 해당 사용자의 사진을 검색합니다.
사용자 사진 메타데이터 가져오기

사용자 사진 메타데이터를 가져옵니다.
사용자 프로필 가져오기(V1) [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 사용자 프로필 가져오기(V2) 를 사용하세요.

특정 사용자의 프로필을 검색합니다.
사용자 프로필 가져오기(V2)

특정 사용자의 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
직접 보고서 가져오기(V1) [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 직접 보고서 가져오기(V2) 를 사용하세요.

지정된 사용자의 직접 보고서의 사용자 프로필을 검색합니다.
직접 보고서 가져오기(V2)

지정된 사용자의 직접 보고서의 사용자 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
최신 문서 가져오기

로그인한 사용자의 추세 문서를 검색합니다.
최신 문서 가져오기

사용자의 추세 문서를 검색합니다.

HTTP 요청 보내기

작업 ID:
HttpRequest

호출할 Microsoft Graph REST API 요청을 생성합니다. 이러한 세그먼트는 지원됩니다. 첫 번째 세그먼트: /me, /users/<userId> 2번째 세그먼트: 메시지, mailFolders, 이벤트, 일정, 일정, outlook, inferenceClassification. https://docs.microsoft.com/en-us/graph/use-the-api에서 자세한 내용을 알아보세요.

매개 변수

Name 키 필수 형식 Description
URI
 Uri True string

전체 또는 상대 URI입니다. 예: https://graph.microsoft.com/{version}/{resource}.
메서드
 Method True string

HTTP 메서드(기본값은 GET)입니다.
몸
 Body binary

요청 본문 콘텐츠입니다.
콘텐츠 유형 (Content-Type)
 ContentType string

본문의 콘텐츠 형식 헤더입니다(기본값은 application/json).
CustomHeader1
 CustomHeader1 string

사용자 지정 헤더 1. 형식으로 지정: header-name: header-value
CustomHeader2
 CustomHeader2 string

사용자 지정 헤더 2. 형식으로 지정: header-name: header-value
CustomHeader3
 CustomHeader3 string

사용자 지정 헤더 3. 형식으로 지정: header-name: header-value
CustomHeader4
 CustomHeader4 string

사용자 지정 헤더 4. 형식으로 지정: header-name: header-value
CustomHeader5
 CustomHeader5 string

사용자 지정 헤더 5. 형식으로 지정: header-name: header-value

반환

response
ObjectWithoutType

관련 사용자 가져오기

작업 ID:
RelevantPeople

관련 사용자를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 userId True string

사용자 계정 이름 또는 ID입니다.

반환

Graph API의 목록을 나타냅니다.

몸
LinklessEntityListResponse[List[Person]]

관리자 가져오기(V1) [사용되지 않음]

작업 ID:
Manager

이 작업은 더 이상 사용되지 않습니다. 대신 Get 관리자(V2) 를 사용하세요.

지정된 사용자 관리자의 프로필을 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 userId True string

사용자 계정 이름 또는 ID입니다.

반환

디렉터리의 User 개체를 나타냅니다.

몸
User

관리자 가져오기(V2)

작업 ID:
Manager_V2

지정된 사용자 관리자의 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 id True string

사용자 계정 이름 또는 ID입니다.
필드 선택
 $select string

선택할 필드의 쉼표로 구분된 목록입니다. 예: 성, 부서, jobTitle

반환

Graph API의 사용자

몸
GraphUser_V1

내 프로필 가져오기(V1) [사용되지 않음]

작업 ID:
MyProfile

이 작업은 더 이상 사용되지 않습니다. 대신 내 프로필 가져오기(V2)를 사용하세요.

현재 사용자의 프로필을 검색합니다.

반환

디렉터리의 User 개체를 나타냅니다.

몸
User

내 프로필 가져오기(V2)

작업 ID:
MyProfile_V2

현재 사용자의 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

매개 변수

Name 키 필수 형식 Description
필드 선택
 $select string

선택할 필드의 쉼표로 구분된 목록입니다. 예: 성, 부서, jobTitle

반환

Graph API의 사용자

몸
GraphUser_V1

내 프로필 사진 업데이트

작업 ID:
UpdateMyPhoto

현재 사용자의 프로필 사진을 업데이트합니다. 사진 크기는 4MB 미만이어야 합니다.

매개 변수

Name 키 필수 형식 Description
이미지 콘텐츠
 body True binary

이미지 콘텐츠
콘텐츠 유형 (Content-Type)
 Content-Type True string

이미지 콘텐츠 형식(예: 'image/jpeg')

내 프로필 업데이트

작업 ID:
UpdateMyProfile

현재 사용자의 프로필을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
내 정보
 aboutMe string

내 정보
생일
 birthday date-time

생일
관심사
 interests array of string

관심사
내 사이트
 mySite string

내 사이트
이전 프로젝트
 pastProjects array of string

이전 프로젝트
학교
 schools array of string

학교
기술
 skills array of string

기술

사용자 검색(V2)

작업 ID:
SearchUserV2

검색어(V2)와 일치하는 사용자 프로필을 검색합니다.

매개 변수

Name 키 필수 형식 Description
검색 용어
 searchTerm string

검색 문자열(표시 이름, 지정된 이름, 성, 메일, 메일 애칭 및 사용자 계정 이름에 적용됨).
Top
 top integer

반환할 결과 수를 제한합니다. 최소값은 1입니다. 기본값은 1000입니다.
검색 용어가 필요한가요?
 isSearchTermRequired boolean

'예'로 설정하면 검색 용어가 비어 있으면 사용자 프로필이 반환되지 않습니다. '아니요'로 설정하면 검색 용어가 비어 있을 때 필터링이 적용되지 않습니다.

반환

Office API의 엔터티 목록 응답을 나타내는 클래스입니다.

몸
EntityListResponse[IReadOnlyList[User]]

사용자 검색 [사용되지 않음]

작업 ID:
SearchUser

이 작업은 더 이상 사용되지 않습니다. 대신 사용자 검색(V2) 을 사용하세요.

검색 용어와 일치하는 사용자 프로필을 검색합니다.

매개 변수

Name 키 필수 형식 Description
검색 용어
 searchTerm string

검색 문자열(표시 이름, 지정된 이름, 성, 메일, 메일 애칭 및 사용자 계정 이름에 적용됨).
Top
 top integer

반환할 결과 수를 제한합니다. 기본적으로 모든 항목을 반환합니다.

반환

response
array of User

사용자 사진 가져오기(V1) [사용되지 않음]

작업 ID:
UserPhoto

이 작업은 더 이상 사용되지 않습니다. 대신 사용자 사진 가져오기(V2) 를 사용하세요.

지정된 사용자의 사진이 있는 경우 해당 사용자의 사진을 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 userId True string

사용자 계정 이름 또는 ID입니다.

반환

이미지 파일 콘텐츠
binary

사용자 사진 가져오기(V2)

작업 ID:
UserPhoto_V2

지정된 사용자의 사진이 있는 경우 해당 사용자의 사진을 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 id True string

사용자 계정 이름 또는 ID입니다.

반환

이미지 파일 콘텐츠
binary

사용자 사진 메타데이터 가져오기

작업 ID:
UserPhotoMetadata

사용자 사진 메타데이터를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 userId True string

사용자 계정 이름 또는 ID입니다.

반환

사진 메타데이터 클래스

몸
ClientPhotoMetadata

사용자 프로필 가져오기(V1) [사용되지 않음]

작업 ID:
UserProfile

이 작업은 더 이상 사용되지 않습니다. 대신 사용자 프로필 가져오기(V2) 를 사용하세요.

특정 사용자의 프로필을 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 userId True string

사용자 계정 이름 또는 ID입니다.

반환

디렉터리의 User 개체를 나타냅니다.

몸
User

사용자 프로필 가져오기(V2)

작업 ID:
UserProfile_V2

특정 사용자의 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 id True string

사용자 계정 이름 또는 ID입니다.
필드 선택
 $select string

선택할 필드의 쉼표로 구분된 목록입니다. 예: 성, 부서, jobTitle

반환

Graph API의 사용자

몸
GraphUser_V1

직접 보고서 가져오기(V1) [사용되지 않음]

작업 ID:
DirectReports

이 작업은 더 이상 사용되지 않습니다. 대신 직접 보고서 가져오기(V2) 를 사용하세요.

지정된 사용자의 직접 보고서의 사용자 프로필을 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 userId True string

사용자 계정 이름 또는 ID입니다.

반환

response
array of User

직접 보고서 가져오기(V2)

작업 ID:
DirectReports_V2

지정된 사용자의 직접 보고서의 사용자 프로필을 검색합니다. 선택할 수 있는 필드에 대해 자세히 알아보세요. https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 id True string

사용자 계정 이름 또는 ID입니다.
필드 선택
 $select string

선택할 필드의 쉼표로 구분된 목록입니다. 예: 성, 부서, jobTitle
Top
 $top integer

반환할 결과 수를 제한합니다. 기본적으로 모든 항목을 반환합니다.

반환

Name 경로 형식 Description
value
 value array of GraphUser_V1

가치

최신 문서 가져오기

작업 ID:
MyTrendingDocuments

로그인한 사용자의 추세 문서를 검색합니다.

매개 변수

Name 키 필수 형식 Description
쿼리 필터링
 $filter string

선택한 리소스를 필터링하는 OData 필터입니다. ResourceVisualization/Type 또는 ResourceVisualization/containerType에서 선택한 리소스 필터링
민감도 레이블 추출
 extractSensitivityLabel boolean

민감도 레이블(false, true)을 추출할지 선택합니다.
민감도 레이블 메타데이터
 fetchSensitivityLabelMetadata boolean

연결된 LabelId에 대한 민감도 레이블 메타데이터를 가져올지 여부를 나타내는 부울입니다.

반환

Name 경로 형식 Description
value
 value array of GraphTrending

value

최신 문서 가져오기

작업 ID:
TrendingDocuments

사용자의 추세 문서를 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자(UPN)
 id True string

사용자 계정 이름 또는 ID입니다.
쿼리 필터링
 $filter string

선택한 리소스를 필터링하는 OData 필터입니다. ResourceVisualization/Type 또는 ResourceVisualization/containerType에서 선택한 리소스 필터링
민감도 레이블 추출
 extractSensitivityLabel boolean

민감도 레이블(false, true)을 추출할지 선택합니다.
민감도 레이블 메타데이터
 fetchSensitivityLabelMetadata boolean

연결된 LabelId에 대한 민감도 레이블 메타데이터를 가져올지 여부를 나타내는 부울입니다.

반환

Name 경로 형식 Description
value
 value array of GraphTrending

value

정의

GraphTrending

Graph API의 추세 문서

Name 경로 형식 Description
아이디
 id string

관계의 고유 식별자
Weight
 weight float

문서가 현재 추세에 얼마나 많은지 나타내는 값
리소스 시각화
 resourceVisualization resourceVisualization

resourceVisualization
sensitivityLabelInfo
 sensitivityLabelInfo array of sensitivityLabelMetadata

resourceVisualization

resourceVisualization

Name 경로 형식 Description
제목
 title string

항목의 제목 텍스트
유형
 type string

항목의 미디어 형식(특정 형식에 따라 특정 파일을 필터링하는 데 사용할 수 있습니다).
미디어 유형
 mediaType string

항목 미디어 형식(지원되는 IANA Media MIME 형식에 따라 특정 형식의 파일을 필터링하는 데 사용할 수 있음)
이미지 URL 미리 보기
 previewImageUrl string

항목에 대한 미리 보기 이미지로 이어지는 URL
미리 보기 텍스트
 previewText string

항목의 미리 보기 텍스트
컨테이너 웹 URL
 containerWebUrl string

항목이 저장되는 폴더로 이어지는 경로입니다.
컨테이너 표시 이름
 containerDisplayName string

항목이 저장되는 위치를 설명하는 문자열입니다.
컨테이너 유형
 containerType string

파일이 저장되는 컨테이너 유형별로 필터링하는 데 사용할 수 있습니다.

sensitivityLabelMetadata

Name 경로 형식 Description
sensitivityLabelId
 sensitivityLabelId string

SensitivityLabel ID입니다.
이름
 name string

SensitivityLabel 이름입니다.
표시 이름
 displayName string

SensitivityLabel displayName 정보
도구 설명
 tooltip string

도구 설명에 대한 SensitivityLabel 세부 정보입니다.
우선순위
 priority integer

SensitivityLabel 우선 순위입니다.
color
 color string

SensitivityLabel 색입니다.
암호화됨
 isEncrypted boolean

는 SensitivityLabel Encrypted입니다.
활성화됨
 isEnabled boolean

SensitivityLabel을 사용할 수 있는지 여부입니다.
isParent
 isParent boolean

SensitivityLabel이 부모인지 여부입니다.
parentSensitivityLabelId
 parentSensitivityLabelId string

부모 SensitivityLabel ID입니다.

LinklessEntityListResponse[List[Person]]

Graph API의 목록을 나타냅니다.

Name 경로 형식 Description
value
 value array of Person

가치

사람

사람을 나타냅니다.

Name 경로 형식 Description
개인 ID
 id string

디렉터리의 Person 개체에 대한 고유 식별자입니다.
표시 이름
 displayName string

사용자의 표시 이름
이름(개인 이름)
 givenName string

해당 사용자의 지정된 이름
Surname
 surname string

사람의 성
생일
 birthday string

사람의 생일
개인 정보
 personNotes string

현재 사용자가 이 사용자에 대해 수행한 자유 양식 노트
즐겨찾기인가요?
 isFavorite boolean

현재 사용자가 이 사용자를 즐겨찾기로 플래그 지정한 경우
직함
 jobTitle string

해당 사용자의 직호
회사 이름
 companyName string

해당 사용자의 회사 이름
부서
 department string

해당 사용자의 부서
Office 위치
 officeLocation string

사용자의 사무실 위치
직업
 profession string

사람의 직업
UPN(사용자 계정 이름)
 userPrincipalName string

사용자의 UPN(사용자 계정 이름)입니다. UPN은 인터넷 표준 RFC 822를 기반으로 하는 사용자의 인터넷 스타일 로그인 이름입니다. 규칙에 따라 사용자의 전자 메일 이름에 매핑됩니다. 일반 형식은 테넌트의 확인된 도메인 컬렉션에 도메인이 있어야 하는 별칭 @domain입니다.
IM 주소
 imAddress string

사용자의 VOIP SIP 주소
점수가 매기된 전자 메일 주소
 scoredEmailAddresses array of ScoredEmailAddress

관련성 점수가 있는 사용자의 전자 메일 주소 컬렉션
전화
 phones array of Phone

사용자의 전화 번호

ScoredEmailAddress

점수가 매기된 전자 메일 주소를 나타냅니다.

Name 경로 형식 Description
이메일 주소
 address string

전자 메일 주소
관련성 점수
 relevanceScore double

전자 메일 주소의 관련성 점수입니다. 관련성 점수는 반환된 다른 결과와 관련하여 정렬 키로 사용됩니다. 관련성 점수 값이 높을수록 관련성이 높은 결과에 해당합니다. 관련성은 사용자의 통신 및 공동 작업 패턴 및 비즈니스 관계에 따라 결정됩니다.

Phone

전화 번호를 나타냅니다.

Name 경로 형식 Description
전화 번호
 number string

전화 번호
전화 유형
 type string

전화 번호의 유형입니다. 가능한 값: 홈, 비즈니스, 모바일, 기타, 도우미, homeFax, businessFax, 기타 팩스, 호출기, 라디오.

사용자

디렉터리의 User 개체를 나타냅니다.

Name 경로 형식 Description
사용자 ID
 Id string

디렉터리의 사용자 개체에 대한 고유 식별자입니다.
계정을 사용하도록 설정되었나요?
 AccountEnabled boolean

계정이 활성화된 경우 true입니다. 그렇지 않으면 false입니다. 이 속성은 사용자를 만들 때 필요합니다.
회사 전화
 BusinessPhones array of string

사용자의 회사 전화 번호 목록
도시
 City string

사용자가 있는 도시입니다.
회사 이름
 CompanyName string

사용자가 작동하는 회사의 이름입니다.
국가
 Country string

사용자가 있는 국가/지역입니다. 예를 들어 "US" 또는 "UK"입니다.
부서
 Department string

사용자가 작동하는 부서의 이름입니다.
표시 이름
 DisplayName string

사용자의 주소록에 표시되는 이름입니다. 이는 일반적으로 사용자의 이름, 중간 이니셜 및 성의 조합입니다. 이 속성은 사용자가 생성될 때 필요하며 업데이트 중에는 지울 수 없습니다.
이름(개인 이름)
 GivenName string

사용자의 지정된 이름(이름)입니다.
직함
 JobTitle string

사용자의 직호입니다.
전자 메일
 Mail string

사용자의 SMTP/이메일 주소(예: "jeff@contoso.onmicrosoft.com")입니다. 읽기 전용입니다.
애칭
 MailNickname string

사용자의 메일 별칭입니다. 이 속성은 사용자를 만들 때 지정해야 합니다.
Office 위치
 OfficeLocation string

사용자의 비즈니스 위치에 있는 사무실 위치입니다.
우편번호
 PostalCode string

사용자의 우편 주소에 대한 우편 번호입니다. 우편 번호는 사용자의 국가/지역과 관련이 있습니다. 미국에서는 이 특성에 우편 번호가 포함됩니다.
Surname
 Surname string

사용자의 성(가족 이름 또는 성)입니다.
전화번호
 TelephoneNumber string

사용자의 기본 셀룰러 전화 번호입니다.
UPN(사용자 계정 이름)
 UserPrincipalName string

사용자의 UPN(사용자 계정 이름)입니다. UPN은 인터넷 표준 RFC 822를 기반으로 하는 사용자의 인터넷 스타일 로그인 이름입니다. 규칙에 따라 사용자의 전자 메일 이름에 매핑됩니다. 일반 형식은 alias@domain. 여기서 도메인은 테넌트의 확인된 도메인 컬렉션에 있어야 합니다.

ClientPhotoMetadata

사진 메타데이터 클래스

Name 경로 형식 Description
사진이 있습니다.
 HasPhoto boolean

사진이 있습니다.
높이
 Height integer

사진 높이
너비
 Width integer

사진 너비
콘텐츠 유형
 ContentType string

사진의 콘텐츠 형식
이미지 파일 확장자
 ImageFileExtension string

사진의 파일 확장명(예: ".jpg")

EntityListResponse[IReadOnlyList[User]]

Office API의 엔터티 목록 응답을 나타내는 클래스입니다.

Name 경로 형식 Description
value
 value array of User

가치
@odata.nextLink
 @odata.nextLink string

다음 페이지 링크

GraphUser_V1

Graph API의 사용자

Name 경로 형식 Description
내 정보
 aboutMe string

내 정보
계정을 사용하도록 설정되었나요?
 accountEnabled boolean

계정이 활성화된 경우 true입니다. 그렇지 않으면 false입니다. 이 속성은 사용자를 만들 때 필요합니다.
생일
 birthday date-time

생일
회사 전화
 businessPhones array of string

회사 전화
도시
 city string

사용자가 있는 도시입니다.
회사 이름
 companyName string

사용자가 작동하는 회사의 이름입니다.
국가
 country string

사용자가 있는 국가/지역입니다. 예를 들어 "US" 또는 "UK"입니다.
부서
 department string

사용자가 작동하는 부서의 이름입니다.
표시 이름
 displayName string

표시 이름
이름 (주어진 이름)
 givenName string

이름 (주어진 이름)
고용 날짜
 hireDate date-time

고용 날짜
아이디
 id string

아이디
관심사
 interests array of string

관심사
직위
 jobTitle string

직위
우편
 mail string

우편
애칭
 mailNickname string

사용자의 메일 별칭입니다. 이 속성은 사용자를 만들 때 지정해야 합니다.
휴대폰(Mobile Phone)
 mobilePhone string

휴대폰(Mobile Phone)
내 사이트
 mySite string

내 사이트
Office 위치
 officeLocation string

Office 위치
이전 프로젝트
 pastProjects array of string

이전 프로젝트
우편번호
 postalCode string

사용자의 우편 주소에 대한 우편 번호입니다. 우편 번호는 사용자의 국가/지역과 관련이 있습니다. 미국에서는 이 특성에 우편 번호가 포함됩니다.
기본 설정 언어
 preferredLanguage string

기본 설정 언어
기본 설정 이름
 preferredName string

기본 설정 이름
책무
 responsibilities array of string

책무
학교
 schools array of string

학교
기술
 skills array of string

기술
주
 state string

주
거리 주소
 streetAddress string

거리 주소
Surname
 surname string

Surname
사용자 주 이름
 userPrincipalName string

사용자 주 이름
사용자 유형
 userType string

사용자 유형

ObjectWithoutType

이진법

기본 데이터 형식 'binary'입니다.