SharePoint Embedded

Microsoft SharePoint Embedded는 모든 애플리케이션에서 사용하기에 적합한 클라우드 기반 파일 및 문서 관리 시스템입니다. SharePoint Embedded는 앱 개발자가 모든 앱에 대해 Microsoft 365 파일 및 문서 스토리지 플랫폼의 기능을 활용할 수 있도록 하는 API 전용 솔루션이며, LOB(기간 업무) 애플리케이션 및 ISV에서 다중 테넌트 애플리케이션을 빌드하는 기업에 적합합니다.

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

서비스	클래스	Regions
Copilot Studio	스탠다드	다음을 제외한 모든 Power Automate 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
논리 앱	스탠다드	다음을 제외한 모든 Logic Apps 지역 :      - Azure Government 지역      - Azure 중국 지역      - 미국 국방부(DoD)
Power Apps	스탠다드	다음을 제외한 모든 Power Apps 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
Power Automate (파워 오토메이트)	스탠다드	다음을 제외한 모든 Power Automate 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)

연락처
이름	Microsoft
URL	https://learn.microsoft.com/en-us/sharepoint/dev/embedded/overview
전자 메일	spe-connector@service.microsoft.com

커넥터 메타데이터
게시자	Microsoft
웹 사이트	https://learn.microsoft.com/en-us/sharepoint/dev/embedded/overview
개인 정보 보호 정책	https://privacy.microsoft.com/
카테고리	콘텐츠 및 파일

시작하기

SharePoint Embedded 커넥터를 사용하려면 SharePoint Embedded 애플리케이션을 만들어야 합니다. 자세히 알아보고 시작하려면 SharePoint Embedded 설명서를 참조하세요.

SharePoint Embedded Connector에 대한 액세스 권한 부여

SharePoint Embedded 커넥터가 테넌트의 파일 스토리지 컨테이너 및 콘텐츠와 상호 작용하려면 해당 테넌트에 SharePoint Embedded 커넥터 애플리케이션을 containerTypeRegistration 만들어야 applicationPermissionGrant 합니다. 이렇게 하면 SharePoint Embedded 커넥터가 테넌트에서 앱의 특정 컨테이너 유형에 액세스할 수 있습니다.

Microsoft Graph API를 사용하는 호출에 대해 SharePoint Embedded 커넥터 애플리케이션 ID e8e1b0bf-140f-4b8b-8e94-fbe8937fad04 에 권한을 delegated 부여 full 합니다.

PUT /storage/fileStorage/containerTypeRegistrations/{containerTypeId}/applicationPermissionGrants/e8e1b0bf-140f-4b8b-8e94-fbe8937fad04
Content-Type: application/json
{
  "delegatedPermissions": ["full"],
  "applicationPermissions": ["none"]
}

자세한 내용은 fileStorageContainerTypeAppPermissionGrant API 참조 문서 만들기를 참조하세요.

알려진 문제 및 제한 사항

• 파일 만들기 작업을 사용하여 지원되는 최대 파일 크기는 10MB입니다.
• 커넥터에서 컨테이너를 만들 수 없습니다.
• 위임된 인증만 지원됩니다.

동작

공유 권한 가져오기	이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 특정 공유 권한을 가져옵니다.
공유 권한 삭제	이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 특정 공유 권한을 삭제합니다.
공유 링크 만들기	이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 공유 링크를 만듭니다.
공유 초대 보내기	이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 공유 초대를 보냅니다.
미리 보기 가져오기	이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 특정 썸네일을 가져옵니다.
썸네일 나열	이 작업에는 SharePoint Embedded 컨테이너의 파일에 사용할 수 있는 미리 보기가 나열됩니다.
재활용 항목 나열	이 작업은 SharePoint Embedded 컨테이너의 휴지통에 있는 항목을 나열합니다.
재활용된 컨테이너 나열	재활용된 컨테이너 나열
재활용된 컨테이너 복원	재활용된 컨테이너 복원
재활용된 컨테이너 삭제	재활용된 컨테이너를 영구적으로 삭제
재활용된 항목 복원	이 작업은 SharePoint Embedded 컨테이너의 휴지통에서 하나 이상의 재활용 항목을 복원합니다.
재활용된 항목 삭제	이 작업은 SharePoint Embedded 컨테이너의 휴지통에서 하나 이상의 재활용 항목을 영구적으로 삭제합니다.
체크 아웃 삭제	이 작업은 SharePoint Embedded 컨테이너의 파일 체크 아웃을 삭제합니다.
체크 아웃 파일	이 작업은 SharePoint Embedded 컨테이너의 파일을 체크 아웃하여 다른 사용자가 문서를 편집하지 못하게 합니다.
컨테이너 가져오기	컨테이너 가져오기
컨테이너 권한 나열	컨테이너에 대한 권한 나열
컨테이너 권한 만들기	컨테이너에 대한 권한 만들기
컨테이너 권한 삭제	컨테이너에 대한 권한 삭제
컨테이너 권한 업데이트	컨테이너에 대한 권한 업데이트
컨테이너 나열	컨테이너 나열
컨테이너 사용자 지정 속성 가져오기	컨테이너의 사용자 지정 속성 가져오기
컨테이너 사용자 지정 속성 업데이트	컨테이너의 사용자 지정 속성 업데이트
컨테이너 삭제	컨테이너 삭제
컨테이너 업데이트	컨테이너 업데이트
컨테이너 열 가져오기	컨테이너의 열 가져오기
컨테이너 열 나열	컨테이너의 스키마를 정의하는 열 나열
컨테이너 열 만들기	컨테이너의 스키마를 정의하는 열 만들기
컨테이너 열 삭제	컨테이너의 스키마를 정의하는 열 삭제
컨테이너 활성화	컨테이너 활성화
컨테이너의 항목 나열	이 작업은 컨테이너의 파일 및 하위 폴더 목록을 가져옵니다.
파일 만들기	이 작업은 파일을 만들고 driveItem의 메타데이터를 반환합니다.
파일 미리 보기 만들기	이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 미리 보기를 만듭니다.
파일 버전 가져오기	이 작업은 SharePoint Embedded 컨테이너에 있는 파일의 특정 버전을 가져옵니다.
파일 버전 나열	이 작업은 SharePoint Embedded 컨테이너에 있는 파일의 이전 버전을 나열합니다.
파일 버전 삭제	이 작업은 SharePoint Embedded 컨테이너에서 특정 버전의 파일을 삭제합니다.
파일 삭제	이 작업은 SharePoint Embedded 컨테이너의 파일을 삭제합니다.
파일 속성 가져오기	이 작업은 SharePoint Embedded 컨테이너에 있는 파일의 속성을 가져옵니다.
파일 이름 바꾸기	이 작업은 SharePoint Embedded 컨테이너의 파일 이름을 바꿉니다.
파일 체크 인	이 작업은 SharePoint Embedded 컨테이너에서 체크 아웃된 파일을 확인합니다.
파일 콘텐츠 가져오기	이 작업은 파일의 콘텐츠를 가져옵니다.
파일 콘텐츠 업데이트	이 작업은 파일의 콘텐츠를 업데이트합니다.
파일 필드 나열	이 작업은 SharePoint Embedded 컨테이너의 파일과 연결된 목록 항목 필드(메타데이터)를 가져옵니다.
파일 필드 설정	이 작업은 SharePoint Embedded 컨테이너의 파일과 연결된 목록 항목 필드(메타데이터)를 업데이트합니다. null 값을 사용하여 필드 값을 지울 수 있습니다.
폴더 만들기	이 작업은 루트 수준 또는 다른 폴더 내에서 SharePoint Embedded 컨테이너에 새 폴더를 만듭니다.
항목 공유 권한 나열	이 작업은 SharePoint Embedded 컨테이너의 항목에 대한 공유 권한을 나열합니다.

공유 권한 가져오기

작업 ID:

GetSharingPermission

이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 특정 공유 권한을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
사용 권한 ID	permission-id	True	string	사용 권한의 고유 식별자입니다.

반환

파일 또는 폴더에 대한 사용 권한을 나타냅니다.

몸

SharingPermissionResponse

공유 권한 삭제

작업 ID:

DeleteSharingPermission

이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 특정 공유 권한을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
사용 권한 ID	permission-id	True	string	삭제할 권한의 고유 식별자입니다.

공유 링크 만들기

작업 ID:

CreateSharingLink

이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 공유 링크를 만듭니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
링크 유형	type	True	string	만들 공유 링크의 유형입니다.
링크 범위	scope		string	공유 링크의 범위
만료 날짜	expirationDateTime		date-time	링크가 만료되는 날짜 및 시간(yyyy-MM-ddTHH:mm:ssZ)

반환

파일 또는 폴더의 공유 링크를 나타냅니다.

몸

SharingLink

공유 초대 보내기

작업 ID:

SendSharingInvitation

이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 공유 초대를 보냅니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
로그인 필요	requireSignIn	True	boolean	공유 항목을 보기 위해 로그인하는 데 초대 받는 사람이 필요한지 여부를 나타냅니다.
역할	roles	True	array of string	공유 초대의 받는 사람에게 부여된 권한
전자 메일	email		string	받는 사람의 전자 메일 주소
Alias	alias		string	받는 사람의 별칭(Microsoft 365 받는 사람의 경우)
오브젝트 ID	objectId		string	Azure Active Directory에서 받는 사람의 고유 식별자
Message	message	True	string	공유 초대의 일부로 전송된 사용자 지정 메시지
초대 보내기	sendInvitation	True	boolean	true이면 공유 링크가 받는 사람에게 전송됩니다. false이면 권한이 만들어지지만 초대 메시지가 전송되지 않습니다.

반환

파일 또는 폴더에 대한 사용 권한 목록을 나타냅니다.

몸

SharingPermissionsList

미리 보기 가져오기

작업 ID:

GetFileThumbnail

이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 특정 썸네일을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
썸네일 ID	thumbnail-id	True	string	썸네일 집합의 고유 식별자입니다.
Size	size	True	string	검색할 썸네일의 크기

반환

단일 썸네일을 나타냅니다.

몸

Thumbnail

썸네일 나열

작업 ID:

ListFileThumbnails

이 작업에는 SharePoint Embedded 컨테이너의 파일에 사용할 수 있는 미리 보기가 나열됩니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

반환

썸네일 집합의 컬렉션을 나타냅니다.

몸

ThumbnailSets

재활용 항목 나열

작업 ID:

ListRecycledFiles

이 작업은 SharePoint Embedded 컨테이너의 휴지통에 있는 항목을 나열합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.

반환

휴지통의 항목 컬렉션

몸

RecycleBinItemCollection

재활용된 컨테이너 나열

작업 ID:

ListRecycledContainers

재활용된 컨테이너 나열

매개 변수

Name	키	필수	형식	Description
컨테이너 형식 ID	containerType	True	string	지정된 컨테이너 유형의 재활용된 컨테이너 나열

반환

몸

FileStorageContainer.List

재활용된 컨테이너 복원

작업 ID:

RestoreContainer

재활용된 컨테이너 복원

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

반환

몸

FileStorageContainer

재활용된 컨테이너 삭제

작업 ID:

DeleteContainer

재활용된 컨테이너를 영구적으로 삭제

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

재활용된 항목 복원

작업 ID:

RestoreRecycledFiles

이 작업은 SharePoint Embedded 컨테이너의 휴지통에서 하나 이상의 재활용 항목을 복원합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
항목 ID	ids	True	array of string	복원할 재활용 항목 ID 배열

반환

Name	경로	형식	Description
value	value	array of object
항목 ID	value.id	string	복원된 항목의 ID입니다.

재활용된 항목 삭제

작업 ID:

PermanentDeleteRecycledFiles

이 작업은 SharePoint Embedded 컨테이너의 휴지통에서 하나 이상의 재활용 항목을 영구적으로 삭제합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
항목 ID	ids	True	array of string	영구적으로 삭제할 재활용 항목 ID 배열

체크 아웃 삭제

작업 ID:

DiscardCheckOut

이 작업은 SharePoint Embedded 컨테이너의 파일 체크 아웃을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

체크 아웃 파일

작업 ID:

CheckOutFile

이 작업은 SharePoint Embedded 컨테이너의 파일을 체크 아웃하여 다른 사용자가 문서를 편집하지 못하게 합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

컨테이너 가져오기

작업 ID:

GetContainer

컨테이너 가져오기

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

반환

몸

FileStorageContainer

컨테이너 권한 나열

작업 ID:

ListPermissions

컨테이너에 대한 권한 나열

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

반환

몸

FileStorageContainer.Permissions.List

컨테이너 권한 만들기

작업 ID:

CreatePermission

컨테이너에 대한 권한 만들기

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
권한 역할	roles	True	array of string	사용자에게 부여할 역할
사용자 주 이름	userPrincipalName	True	string	ID 사용자 계정 이름

반환

몸

FileStorageContainer.Permission

컨테이너 권한 삭제

작업 ID:

DeletePermission

컨테이너에 대한 권한 삭제

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
사용 권한 ID	permission-id	True	string	사용 권한 ID

컨테이너 권한 업데이트

작업 ID:

UpdatePermission

컨테이너에 대한 권한 업데이트

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
사용 권한 ID	permission-id	True	string	사용 권한 ID
권한 역할	roles	True	array of string	사용자에게 부여할 역할

반환

몸

FileStorageContainer.Permission

컨테이너 나열

작업 ID:

ListContainers

컨테이너 나열

매개 변수

Name	키	필수	형식	Description
컨테이너 형식 ID	containerType	True	string	지정된 컨테이너 형식의 컨테이너 나열

반환

몸

FileStorageContainer.List

컨테이너 사용자 지정 속성 가져오기

작업 ID:

GetContainerCustomProperties

컨테이너의 사용자 지정 속성 가져오기

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

반환

몸

FileStorageContainer.CustomProperties

컨테이너 사용자 지정 속성 업데이트

작업 ID:

UpdateContainerCustomProperties

컨테이너의 사용자 지정 속성 업데이트

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
			object

반환

몸

FileStorageContainer.CustomProperties

컨테이너 삭제

작업 ID:

RecycleContainer

컨테이너 삭제

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

컨테이너 업데이트

작업 ID:

UpdateContainer

컨테이너 업데이트

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
Description	description		string	컨테이너 설명
표시 이름	displayName		string	컨테이너 이름
OCR 사용	isOcrEnabled		boolean	컨테이너에 OCR(광학 문자 인식)을 사용할 수 있는지 여부
항목 부 버전 제한	itemMinorVersionLimit		integer	컨테이너의 항목에 대해 보존할 부 버전의 최대 수
항목 버전 관리 사용	isItemVersioningEnabled		boolean	컨테이너에 대해 항목 버전 관리가 사용되는지 여부

반환

몸

FileStorageContainer

컨테이너 열 가져오기

작업 ID:

GetContainerColumn

컨테이너의 열 가져오기

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
열 ID	column-id	True	string	열 ID

반환

몸

FileStorageContainer.Column

컨테이너 열 나열

작업 ID:

ListContainerColumns

컨테이너의 스키마를 정의하는 열 나열

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
Filter	$filter		string	결과에 적용할 필터입니다.

반환

몸

FileStorageContainer.Columns.List

컨테이너 열 만들기

작업 ID:

CreateContainerColumn

컨테이너의 스키마를 정의하는 열 만들기

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
			object

반환

몸

FileStorageContainer.Column

컨테이너 열 삭제

작업 ID:

DeleteContainerColumn

컨테이너의 스키마를 정의하는 열 삭제

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID
열 ID	column-id	True	string	열 ID

컨테이너 활성화

작업 ID:

ActivateContainer

컨테이너 활성화

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너 ID

컨테이너의 항목 나열

작업 ID:

ListContainerFiles

이 작업은 컨테이너의 파일 및 하위 폴더 목록을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
부모 폴더 ID	parentId	True	string	항목을 나열할 상위 폴더의 ID입니다. 'root'를 사용하여 컨테이너의 루트 수준에서 항목을 가져오거나 특정 폴더 ID를 제공하여 해당 폴더에서 항목을 가져옵니다.
Filter	$filter		string	결과에 대한 필터 조건(OData 형식) 예: parentReference/id eq '{{folderId}}' AND contains(listitem/fields/FileLeafRef, {{user_name_string}}})
선택	$select		string	결과에 포함할 속성(쉼표로 구분)
확장하다	$expand		string	응답에서 확장할 관련 리소스
최상위	$top		integer	반환할 결과 수
주문 기준	$orderby		string	결과를 정렬할 필드 및 방향

반환

드라이브 항목의 페이지를 나타냅니다.

몸

DriveItemCollectionPage

파일 만들기

작업 ID:

CreateFile

이 작업은 파일을 만들고 driveItem의 메타데이터를 반환합니다.

매개 변수

Name	키	필수	형식	Description
부모 ID	parent-id	True	string	부모 폴더의 드라이브 항목 ID 또는 'root'
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 이름	file-name	True	string	파일의 이름입니다.
파일 콘텐츠(Base64)	body	True	byte	Base64로 인코딩된 파일 콘텐츠

반환

드라이브 항목 메타데이터

몸

DriveItem

파일 미리 보기 만들기

작업 ID:

CreateFilePreview

이 작업은 SharePoint Embedded 컨테이너의 파일에 대한 미리 보기를 만듭니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
페이지	page		integer	미리 볼 문서의 페이지 번호를 지정합니다.
확대/축소 수준	zoom		float	문서 미리 보기의 확대/축소 수준을 지정합니다(예: 0.5, 1.0, 1.5).

반환

Name	경로	형식	Description
URL 가져오기	getUrl	string	GET 요청을 사용하여 미리 보기를 검색하는 데 사용할 수 있는 URL
게시 매개 변수	postParameters	string	POST 요청을 사용하여 미리 보기를 검색하기 위해 postUrl 속성과 함께 사용할 수 있는 매개 변수
게시 URL	postUrl	string	POST 요청을 사용하여 미리 보기를 검색하는 데 사용할 수 있는 URL

파일 버전 가져오기

작업 ID:

GetFileVersion

이 작업은 SharePoint Embedded 컨테이너에 있는 파일의 특정 버전을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
버전 ID	version-id	True	string	버전의 고유 식별자입니다.

반환

파일의 버전을 나타냅니다.

몸

FileVersion

파일 버전 나열

작업 ID:

ListFileVersions

이 작업은 SharePoint Embedded 컨테이너에 있는 파일의 이전 버전을 나열합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

반환

파일 버전의 컬렉션을 나타냅니다.

몸

FileVersions

파일 버전 삭제

작업 ID:

DeleteFileVersion

이 작업은 SharePoint Embedded 컨테이너에서 특정 버전의 파일을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
버전 ID	version-id	True	string	삭제할 버전의 고유 식별자입니다.

파일 삭제

작업 ID:

DeleteFile

이 작업은 SharePoint Embedded 컨테이너의 파일을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

파일 속성 가져오기

작업 ID:

GetFileProperties

이 작업은 SharePoint Embedded 컨테이너에 있는 파일의 속성을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

반환

드라이브 항목 메타데이터

몸

DriveItem

파일 이름 바꾸기

작업 ID:

RenameFile

이 작업은 SharePoint Embedded 컨테이너의 파일 이름을 바꿉니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
이름	name		string	파일의 새 이름

반환

드라이브 항목 메타데이터

몸

DriveItem

파일 체크 인

작업 ID:

CheckInFile

이 작업은 SharePoint Embedded 컨테이너에서 체크 아웃된 파일을 확인합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
주석	comment		string	버전과 연결된 체크 인 주석
다음으로 체크 인	checkInAs		string	체크 인 후의 문서 상태(게시된 문서 또는 부 버전)

파일 콘텐츠 가져오기

작업 ID:

GetFileContent

이 작업은 파일의 콘텐츠를 가져옵니다.

매개 변수

Name	키	필수	형식	Description
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.

파일 콘텐츠 업데이트

작업 ID:

UpdateFileContent

이 작업은 파일의 콘텐츠를 업데이트합니다.

매개 변수

Name	키	필수	형식	Description
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 콘텐츠(Base64)	body	True	byte	Base64로 인코딩된 파일 콘텐츠

반환

파일의 내용

파일 콘텐츠

binary

파일 필드 나열

작업 ID:

ListFileFields

이 작업은 SharePoint Embedded 컨테이너의 파일과 연결된 목록 항목 필드(메타데이터)를 가져옵니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.

반환

Name	경로	형식	Description
ETag	@odata.etag	string	필드의 ETag 값입니다.

파일 필드 설정

작업 ID:

UpdateFileFields

이 작업은 SharePoint Embedded 컨테이너의 파일과 연결된 목록 항목 필드(메타데이터)를 업데이트합니다. null 값을 사용하여 필드 값을 지울 수 있습니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
파일 ID	file-id	True	string	파일의 고유 식별자입니다.
			object

반환

Name	경로	형식	Description
ETag	@odata.etag	string	필드의 ETag 값입니다.

폴더 만들기

작업 ID:

CreateFolder

이 작업은 루트 수준 또는 다른 폴더 내에서 SharePoint Embedded 컨테이너에 새 폴더를 만듭니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
부모 폴더 ID	parent-id	True	string	새 폴더를 만들 상위 폴더의 ID입니다. 'root'를 사용하여 컨테이너의 루트 수준에서 폴더를 만들거나 특정 폴더 ID를 제공하여 중첩된 폴더를 만듭니다.
폴더 이름	name	True	string	만들 폴더의 이름입니다.
충돌 동작	@microsoft.graph.conflictBehavior		string	이름이 같은 폴더가 이미 있는 경우 수행할 작업

반환

드라이브 항목 메타데이터

몸

DriveItem

항목 공유 권한 나열

작업 ID:

ListSharingPermissions

이 작업은 SharePoint Embedded 컨테이너의 항목에 대한 공유 권한을 나열합니다.

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	컨테이너의 고유 식별자입니다.
항목 ID	file-id	True	string	항목의 고유 식별자입니다.

반환

파일 또는 폴더에 대한 사용 권한 목록을 나타냅니다.

몸

SharingPermissionsList

트리거

컨테이너의 항목 변경 내용 모니터링

SharePoint Embedded 컨테이너에서 항목이 추가, 수정 또는 삭제될 때 트리거

컨테이너의 항목 변경 내용 모니터링

작업 ID:

GetChangesContainer

SharePoint Embedded 컨테이너에서 항목이 추가, 수정 또는 삭제될 때 트리거

매개 변수

Name	키	필수	형식	Description
컨테이너 ID	container-id	True	string	모니터링할 컨테이너의 ID
폴링 간격(초)	pollingInterval		integer	변경 내용을 확인하는 빈도(60-3600초, 기본값: 300)

반환

Name	경로	형식	Description
value	value	array of DriveItem	변경된 항목 목록
@odata.deltaLink	@odata.deltaLink	string	다음 폴링 요청에 대한 델타 링크
@odata.context	@odata.context	string	@odata.context

정의

FileStorageContainer

Name	경로	형식	Description
컨테이너 ID	id	string	컨테이너 ID
컨테이너 형식 ID	containerTypeId	string	이 컨테이너가 속한 컨테이너 형식의 ID입니다.
Description	description	string	컨테이너 설명
표시 이름	displayName	string	컨테이너 이름
만든 시간	createdDateTime	date-time	컨테이너 생성 날짜 및 시간
customProperties	customProperties	FileStorageContainer.CustomProperties
permissions	permissions	FileStorageContainer.Permissions
status	status	string	컨테이너 상태

FileStorageContainer.List

Name	경로	형식	Description
value	value	array of FileStorageContainer

FileStorageContainer.Permissions

Name	경로	형식	Description
아이템		FileStorageContainer.Permission

FileStorageContainer.Permission

Name	경로	형식	Description
사용 권한 ID	id	string	사용 권한 ID
권한 역할	roles	FileStorageContainer.Permission.Roles	사용자에게 부여할 역할
표시 이름	grantedToV2.user.displayName	string	ID 표시 이름
전자 메일	grantedToV2.user.email	string	ID 전자 메일
사용자 주 이름	grantedToV2.user.userPrincipalName	string	ID 사용자 계정 이름

FileStorageContainer.Permission.Roles

사용자에게 부여할 역할

Name	경로	형식	Description
아이템		string

FileStorageContainer.Permissions.List

Name	경로	형식	Description
value	value	FileStorageContainer.Permissions

FileStorageContainer.CustomProperties

FileStorageContainer.Column

Name	경로	형식	Description
열 ID	id	string	열의 고유 식별자입니다.
열 이름	name	string	열의 표시 이름
Description	description	string	열에 대한 설명
고유 값 적용	enforceUniqueValues	boolean	열 값이 고유해야 하는지 여부
숨겨져 있음	hidden	boolean	열이 UI에 표시되는지 여부
인덱싱됨	indexed	boolean	열이 인덱싱되는지 여부
필수	required	boolean	열이 필요한지 여부
읽기 전용	readOnly	boolean	열 값을 수정할 수 있는지 여부
열 그룹	columnGroup	string	이 열이 속한 그룹
표시 이름	displayName	string	열의 표시 이름
삭제 가능	isDeletable	boolean	이 열을 삭제할 수 있는지 여부를 나타냅니다.
순서를 다시 정렬할 수 있습니다.	isReorderable	boolean	이 열의 순서를 변경할 수 있는지 여부를 나타냅니다.
봉인됨	isSealed	boolean	열을 변경할 수 있는지 여부를 지정합니다.
변경 내용 전파	propagateChanges	boolean	true이면 이 열의 변경 내용이 열을 구현하는 목록으로 전파됩니다.
기본값 열 - 수식	defaultValue.formula	string	열의 기본값을 계산하는 데 사용되는 수식입니다.
기본값 열 - 값	defaultValue.value	string	열의 기본값으로 사용할 직접 값입니다.
텍스트 열 - 최대 길이	text.maxLength	integer	최대 텍스트 길이
텍스트 열 - 여러 줄 허용	text.allowMultipleLines	boolean	여러 줄의 텍스트를 허용할지 여부
텍스트 열 - 변경 내용 추가	text.appendChangesToExistingText	boolean	이 열에 대한 업데이트가 기존 텍스트에 추가되어야 하는지 여부
텍스트 열 - 편집할 줄	text.linesForEditing	integer	편집 컨트롤에 표시할 텍스트 줄 수
텍스트 열 - 텍스트 형식	text.textType	string	저장되는 텍스트의 형식입니다.
숫자 열 - 소수 자릿수	number.decimalPlaces	string	표시할 소수 자릿수
숫자 열 - 다음으로 표시	number.displayAs	string	숫자를 표시하는 방법
숫자 열 - 최대값	number.maximum	number	허용되는 최대 값
숫자 열 - 최소	number.minimum	number	허용되는 최소값
불리언	boolean	object	부울 열에 대한 설정
DateTime 열 - 다음으로 표시	dateTime.displayAs	string	날짜 및 시간을 표시하는 방법
DateTime 열 - 형식	dateTime.format	string	날짜에 시간을 포함할지 여부
선택 열 - 텍스트 입력 허용	choice.allowTextEntry	boolean	사용자 지정 값을 입력할 수 있는지 여부
선택 열 - 선택 항목	choice.choices	array of string	열에 대한 선택 항목 목록
선택 열 - 다음으로 표시	choice.displayAs	string	선택 항목을 표시하는 방법
조회 열 - 여러 값 허용	lookup.allowMultipleValues	boolean	여러 값을 선택할 수 있는지 여부
조회 열 - 무제한 길이 허용	lookup.allowUnlimitedLength	boolean	열의 값이 표준 한도인 255자를 초과할 수 있는지 여부입니다.
조회 열 - 목록 ID	lookup.listId	string	이 조회에서 정보를 가져오는 목록의 ID
조회 열 - 기본 조회 열 ID	lookup.primaryLookupColumnId	string	정보를 가져올 열의 ID입니다.
통화 열 - 로캘	currency.locale	string	통화의 로캘
PersonOrGroup 열 - 여러 선택 허용	personOrGroup.allowMultipleSelection	boolean	여러 사용자 또는 그룹을 선택할 수 있는지 여부
PersonOrGroup 열 - 형식에서 선택	personOrGroup.chooseFromType	string	선택할 수 있는 사람 또는 그룹의 유형
PersonOrGroup 열 - 다음으로 표시	personOrGroup.displayAs	string	사용자 또는 그룹을 표시하는 방법
HyperlinkOrPicture 열 - 그림	hyperlinkOrPicture.isPicture	boolean	하이퍼링크가 그림인지 여부
계산 열 - 수식	calculated.formula	string	계산에 대한 수식
계산 열 - 출력 형식	calculated.outputType	string	출력의 형식입니다.
계산 열 - 형식	calculated.format	string	날짜에 시간을 포함할지 여부
지리적 위치 열	geolocation	object	위치 열에 대한 설정
썸네일 열 속성	thumbnail	object	썸네일 열에 대한 설정
콘텐츠 승인 상태 열 속성	contentApprovalStatus	object	이 열은 콘텐츠 승인 상태를 저장합니다.
용어 열 - 여러 값 허용	term.allowMultipleValues	boolean	여러 값을 선택할 수 있는지 여부
용어 열 - 정규화된 이름 표시	term.showFullyQualifiedName	boolean	전체 용어 경로 또는 용어 레이블만 표시할지 여부를 지정합니다.
콘텐츠 형식 ID	sourceContentType.id	string	콘텐츠 형식의 ID입니다.
콘텐츠 형식 이름	sourceContentType.name	string	콘텐츠 형식의 이름입니다.

FileStorageContainer.Columns.List

Name	경로	형식	Description
value	value	array of FileStorageContainer.Column

DriveItemCollectionPage

드라이브 항목의 페이지를 나타냅니다.

Name	경로	형식	Description
value	value	array of DriveItem	드라이브 항목의 컬렉션입니다.
@odata.nextLink	@odata.nextLink	string	다음 페이지를 검색하는 데 사용할 수 있는 URL입니다.

DriveItem

드라이브 항목 메타데이터

Name	경로	형식	Description
URL 다운로드	@microsoft.graph.downloadUrl	string	이 항목의 콘텐츠를 다운로드하는 데 사용할 수 있는 URL
다운로드 URL(인증 없음)	@microsoft.graph.downloadUrlNoAuth	string	인증 없이 이 항목의 콘텐츠를 다운로드하는 데 사용할 수 있는 URL
아이디	id	string	파일 또는 폴더의 고유 식별자
이름	name	string	파일 또는 폴더의 이름
Size	size	integer	파일 또는 폴더 크기(바이트)
웹 URL	webUrl	string	브라우저에서 항목을 표시하는 URL
만든 시간	createdDateTime	date-time	파일 또는 폴더를 만든 날짜 및 시간
마지막으로 수정한 시간	lastModifiedDateTime	date-time	파일 또는 폴더가 마지막으로 수정된 날짜 및 시간입니다.
ETag	eTag	string	파일 또는 폴더의 etag
CTag	cTag	string	콘텐츠가 변경되었음을 나타내는 태그
드라이브 종류	parentReference.driveType	string	항목을 포함하는 드라이브 유형
드라이브 ID	parentReference.driveId	string	항목이 포함된 드라이브의 ID
부모 ID	parentReference.id	string	부모 폴더의 ID
부모 이름	parentReference.name	string	부모 폴더의 이름
부모 경로	parentReference.path	string	부모 폴더의 경로
사이트 아이디	parentReference.siteId	string	항목이 포함된 사이트의 ID
애플리케이션 ID	createdBy.application.id	string	항목을 만든 애플리케이션의 ID
애플리케이션 이름	createdBy.application.displayName	string	항목을 만든 애플리케이션의 표시 이름
사용자 ID	createdBy.user.id	string	항목을 만든 사용자의 ID
사용자 이름	createdBy.user.displayName	string	항목을 만든 사용자의 표시 이름
애플리케이션 ID	lastModifiedBy.application.id	string	항목을 마지막으로 수정한 애플리케이션의 ID
애플리케이션 이름	lastModifiedBy.application.displayName	string	항목을 마지막으로 수정한 애플리케이션의 표시 이름
사용자 ID	lastModifiedBy.user.id	string	항목을 마지막으로 수정한 사용자의 ID
사용자 이름	lastModifiedBy.user.displayName	string	항목을 마지막으로 수정한 사용자의 표시 이름
MIME 형식	file.mimeType	string	파일의 MIME 형식
QuickXor 해시	file.hashes.quickXorHash	string	파일의 QuickXor 해시
만든 시간	fileSystemInfo.createdDateTime	date-time	파일 시스템에 파일 또는 폴더를 만든 날짜 및 시간입니다.
마지막으로 수정한 시간	fileSystemInfo.lastModifiedDateTime	date-time	파일 시스템에서 파일 또는 폴더가 마지막으로 수정된 날짜 및 시간입니다.
자식 수	folder.childCount	integer	폴더의 항목 수
공유 범위	shared.scope	string	공유 범위(사용자, 조직 또는 모든 사용자)

SharingLink

파일 또는 폴더의 공유 링크를 나타냅니다.

Name	경로	형식	Description
링크 ID	id	string	공유 링크의 고유 식별자
링크 유형	link.type	string	공유 링크 유형(보기, 편집, 포함)
링크 범위	link.scope	string	공유 링크의 범위
웹 URL	link.webUrl	string	공유 링크의 URL
디스플레이 이름	link.application.displayName	string	애플리케이션의 표시 이름
아이디	link.application.id	string	애플리케이션의 고유 식별자

SharingPermissionResponse

파일 또는 폴더에 대한 사용 권한을 나타냅니다.

Name	경로	형식	Description
사용 권한 ID	id	string	사용 권한의 고유 식별자입니다.
역할	roles	array of string	이 권한에 대해 부여된 역할
공유 ID	shareId	string	공유 API를 통해 이 공유 항목에 액세스하는 데 사용할 수 있는 고유한 토큰
표시 이름	grantedTo.user.displayName	string	사용자의 표시 이름
전자 메일	grantedTo.user.email	string	사용자의 이메일 주소
사용자 ID	grantedTo.user.id	string	사용자의 고유 식별자입니다.
링크 범위	link.scope	string	링크의 범위
링크 유형	link.type	string	링크의 형식
웹 URL	link.webUrl	string	링크의 URL
전자 메일	invitation.email	string	초대를 보낸 전자 메일 주소
로그인 필요	invitation.signInRequired	boolean	공유 항목에 액세스하는 데 로그인이 필요한지 여부
만료 날짜 시간	expirationDateTime	date-time	사용 권한이 만료되는 날짜 및 시간
ID에 부여됨	grantedToIdentities	array of object	지정하면 나열된 사용자로만 공유를 제한합니다.
표시 이름	grantedToIdentities.user.displayName	string	사용자의 표시 이름
전자 메일	grantedToIdentities.user.email	string	사용자의 이메일 주소
사용자 ID	grantedToIdentities.user.id	string	사용자의 고유 식별자입니다.

SharingPermissionsList

파일 또는 폴더에 대한 사용 권한 목록을 나타냅니다.

Name	경로	형식	Description
value	value	array of SharingPermissionResponse

FileVersion

파일의 버전을 나타냅니다.

Name	경로	형식	Description
버전 ID	id	string	버전의 ID
수정한 사람	lastModifiedBy.user.displayName	string	버전을 수정한 사용자의 이름입니다.
사용자 ID	lastModifiedBy.user.id	string	버전을 수정한 사용자의 ID입니다.
마지막으로 수정한 날짜	lastModifiedDateTime	date-time	이 버전이 마지막으로 수정된 날짜 및 시간입니다.
Size	size	integer	버전 크기(바이트)
게시 수준	publication.level	string	이 버전의 게시 수준(게시 또는 체크 아웃)
버전 ID	publication.versionId	string	게시되는 버전의 ID

FileVersions

파일 버전의 컬렉션을 나타냅니다.

Name	경로	형식	Description
value	value	array of FileVersion	파일 버전 컬렉션

ThumbnailSet

파일의 썸네일 집합을 나타냅니다.

Name	경로	형식	Description
썸네일 집합 ID	id	string	썸네일 집합의 고유 식별자입니다.
크게	large	Thumbnail	단일 썸네일을 나타냅니다.
medium	medium	Thumbnail	단일 썸네일을 나타냅니다.
작다	small	Thumbnail	단일 썸네일을 나타냅니다.
source	source	Thumbnail	단일 썸네일을 나타냅니다.

썸네일

단일 썸네일을 나타냅니다.

Name	경로	형식	Description
높이	height	integer	썸네일의 높이(픽셀)
너비	width	integer	축소판 그림의 너비(픽셀)
URL	url	string	썸네일의 URL

ThumbnailSets

썸네일 집합의 컬렉션을 나타냅니다.

Name	경로	형식	Description
value	value	array of ThumbnailSet	썸네일 집합의 컬렉션

RecycleBinItem

휴지통의 항목을 나타냅니다.

Name	경로	형식	Description
아이디	id	string	재활용된 항목의 고유 식별자
이름	name	string	재활용된 항목의 이름
Size	size	integer	항목 크기(바이트)
삭제된 날짜	deletedDateTime	date-time	항목이 삭제된 날짜 및 시간
위치에서 삭제됨	deletedFromLocation	string	원래 항목이 포함된 위치의 상대 URL
제목	title	string	재활용 항목의 제목
삭제한 작성자	deletedBy.user.displayName	string	항목을 삭제한 사용자의 표시 이름입니다.
전자 메일	deletedBy.user.email	string	항목을 삭제한 사용자의 전자 메일
사용자 ID	deletedBy.user.id	string	항목을 삭제한 사용자의 고유 식별자입니다.

RecycleBinItemCollection

휴지통의 항목 컬렉션

Name	경로	형식	Description
value	value	array of RecycleBinItem	휴지통에 있는 항목의 컬렉션입니다.

이진법

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