更新 contentType

命名空间：microsoft.graph

更新内容 类型。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Sites.Manage.All、Sites.FullControl.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	Sites.Manage.All、Sites.FullControl.All

HTTP 请求

PATCH /sites/{site-id}/contentTypes/{contentType-id}
PATCH /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Content-Type	application/json. Required.

请求正文

在请求正文中，提供要更新的 contentType 资源的 JSON 表示形式。

响应

如果成功，此方法在响应 200 OK 正文中返回 响应代码和更新的 contentType 对象。

示例

请求

HTTP

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}
Content-Type: application/json

{
    "name": "updatedCt",
    "documentSet": {
        "shouldPrefixNameToFile": true,
        "allowedContentTypes": [{
            "id": "0x0101",
            "name": "Document"
        }],
        "defaultContents": [{
                "fileName": "a.txt",
                "contentType": {
                    "id": "0x0101"
                }
            },
            {
                "fileName": "b.txt",
                "contentType": {
                    "id": "0x0101"
                }
            }
        ],
        "sharedColumns": [{
                "name": "Description",
                "id": "cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
            },
            {
                "name": "Address",
                "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
            }
        ],
        "welcomePageColumns": [{
            "name": "Address",
            "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
        }]
    }
}

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const contentType = {
    name: 'updatedCt',
    documentSet: {
        shouldPrefixNameToFile: true,
        allowedContentTypes: [{
            id: '0x0101',
            name: 'Document'
        }],
        defaultContents: [{
                fileName: 'a.txt',
                contentType: {
                    id: '0x0101'
                }
            },
            {
                fileName: 'b.txt',
                contentType: {
                    id: '0x0101'
                }
            }
        ],
        sharedColumns: [{
                name: 'Description',
                id: 'cbb92da4-fd46-4c7d-af6c-3128c2a5576e'
            },
            {
                name: 'Address',
                id: 'fc2e188e-ba91-48c9-9dd3-16431afddd50'
            }
        ],
        welcomePageColumns: [{
            name: 'Address',
            id: 'fc2e188e-ba91-48c9-9dd3-16431afddd50'
        }]
    }
};

await client.api('/sites/{site-id}/contentTypes/{contentType-id}')
    .update(contentType);

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/sites/{site-id}/contentTypes/{contentType-id}"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphContentType *contentType = [[MSGraphContentType alloc] init];
[contentType setName:@"updatedCt"];
MSGraphDocumentSet *documentSet = [[MSGraphDocumentSet alloc] init];
[documentSet setShouldPrefixNameToFile: true];
NSMutableArray *allowedContentTypesList = [[NSMutableArray alloc] init];
MSGraphContentTypeInfo *allowedContentTypes = [[MSGraphContentTypeInfo alloc] init];
[allowedContentTypes setId:@"0x0101"];
[allowedContentTypes setName:@"Document"];
[allowedContentTypesList addObject: allowedContentTypes];
[documentSet setAllowedContentTypes:allowedContentTypesList];
NSMutableArray *defaultContentsList = [[NSMutableArray alloc] init];
MSGraphDocumentSetContent *defaultContents = [[MSGraphDocumentSetContent alloc] init];
[defaultContents setFileName:@"a.txt"];
MSGraphDocumentSetContent *contentType = [[MSGraphDocumentSetContent alloc] init];
[contentType setId:@"0x0101"];
[defaultContents setContentType:contentType];
[defaultContentsList addObject: defaultContents];
MSGraphDocumentSetContent *defaultContents = [[MSGraphDocumentSetContent alloc] init];
[defaultContents setFileName:@"b.txt"];
MSGraphDocumentSetContent *contentType = [[MSGraphDocumentSetContent alloc] init];
[contentType setId:@"0x0101"];
[defaultContents setContentType:contentType];
[defaultContentsList addObject: defaultContents];
[documentSet setDefaultContents:defaultContentsList];
NSMutableArray *sharedColumnsList = [[NSMutableArray alloc] init];
MSGraphColumnDefinition *sharedColumns = [[MSGraphColumnDefinition alloc] init];
[sharedColumns setName:@"Description"];
[sharedColumns setId:@"cbb92da4-fd46-4c7d-af6c-3128c2a5576e"];
[sharedColumnsList addObject: sharedColumns];
MSGraphColumnDefinition *sharedColumns = [[MSGraphColumnDefinition alloc] init];
[sharedColumns setName:@"Address"];
[sharedColumns setId:@"fc2e188e-ba91-48c9-9dd3-16431afddd50"];
[sharedColumnsList addObject: sharedColumns];
[documentSet setSharedColumns:sharedColumnsList];
NSMutableArray *welcomePageColumnsList = [[NSMutableArray alloc] init];
MSGraphColumnDefinition *welcomePageColumns = [[MSGraphColumnDefinition alloc] init];
[welcomePageColumns setName:@"Address"];
[welcomePageColumns setId:@"fc2e188e-ba91-48c9-9dd3-16431afddd50"];
[welcomePageColumnsList addObject: welcomePageColumns];
[documentSet setWelcomePageColumns:welcomePageColumnsList];
[contentType setDocumentSet:documentSet];

NSError *error;
NSData *contentTypeData = [contentType getSerializedDataWithError:&error];
[urlRequest setHTTPBody:contentTypeData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewContentType()
name := "updatedCt"
requestBody.SetName(&name)
documentSet := msgraphsdk.NewDocumentSet()
requestBody.SetDocumentSet(documentSet)
shouldPrefixNameToFile := true
documentSet.SetShouldPrefixNameToFile(&shouldPrefixNameToFile)
documentSet.SetAllowedContentTypes( []ContentTypeInfo {
    msgraphsdk.NewContentTypeInfo(),
id := "0x0101"
    SetId(&id)
name := "Document"
    SetName(&name)
}
documentSet.SetDefaultContents( []DocumentSetContent {
    msgraphsdk.NewDocumentSetContent(),
fileName := "a.txt"
    SetFileName(&fileName)
contentType := msgraphsdk.NewContentTypeInfo()
    SetContentType(contentType)
id := "0x0101"
    contentType.SetId(&id)
    msgraphsdk.NewDocumentSetContent(),
fileName := "b.txt"
    SetFileName(&fileName)
contentType := msgraphsdk.NewContentTypeInfo()
    SetContentType(contentType)
id := "0x0101"
    contentType.SetId(&id)
}
documentSet.SetSharedColumns( []ColumnDefinition {
    msgraphsdk.NewColumnDefinition(),
name := "Description"
    SetName(&name)
id := "cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
    SetId(&id)
    msgraphsdk.NewColumnDefinition(),
name := "Address"
    SetName(&name)
id := "fc2e188e-ba91-48c9-9dd3-16431afddd50"
    SetId(&id)
}
documentSet.SetWelcomePageColumns( []ColumnDefinition {
    msgraphsdk.NewColumnDefinition(),
name := "Address"
    SetName(&name)
id := "fc2e188e-ba91-48c9-9dd3-16431afddd50"
    SetId(&id)
}
siteId := "site-id"
contentTypeId := "contentType-id"
graphClient.SitesById(&siteId).ContentTypesById(&contentTypeId).Patch(requestBody)

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

PowerShell

Import-Module Microsoft.Graph.Sites

$params = @{
    Name = "updatedCt"
    DocumentSet = @{
        ShouldPrefixNameToFile = $true
        AllowedContentTypes = @(
            @{
                Id = "0x0101"
                Name = "Document"
            }
        )
        DefaultContents = @(
            @{
                FileName = "a.txt"
                ContentType = @{
                    Id = "0x0101"
                }
            }
            @{
                FileName = "b.txt"
                ContentType = @{
                    Id = "0x0101"
                }
            }
        )
        SharedColumns = @(
            @{
                Name = "Description"
                Id = "cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
            }
            @{
                Name = "Address"
                Id = "fc2e188e-ba91-48c9-9dd3-16431afddd50"
            }
        )
        WelcomePageColumns = @(
            @{
                Name = "Address"
                Id = "fc2e188e-ba91-48c9-9dd3-16431afddd50"
            }
        )
    }
}

Update-MgSiteContentType -SiteId $siteId -ContentTypeId $contentTypeId -BodyParameter $params

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

响应

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "0x0101009B237E76EF94DC49B4E58139041E7C60",
    "description": "",
    "eTag": "\"7\"",
    "group": "Custom Content Types",
    "hidden": false,
    "name": "testdoc",
    "parentId": "0x0101",
    "base": {
        "id": "0x0101",
        "name": "Document"
    }
}