Merge pull request SharePoint#8905 from kyracatwork/patch-1

New CSOM doc for retention labels

Author: andrewconnell

docs/apis/csom-methods-for-applying-retention-labels.md

@@ -0,0 +1,59 @@
+---
+title: CSOM methods for applying retention labels
+description: CSOM methods are available to apply (set) a retention label (ComplianceTag) on one or many items (ListItems) in SharePoint. 
+author: kyracatwork
+ms.author: kyrachurney
+ms.date: 4/18/2023
+---
+
+# CSOM methods for applying retention labels (setting ComplianceTags)
+
+Retention labels let you apply retention settings for governance control at the item level, and are part of the Microsoft Purview compliance solutions. [Learn more about retention labels.](/microsoft-365/compliance/retention#retention-labels)
+
+Retention labels may classify contents as records, which place restrictions on what actions are allowed or blocked. [Learn more about declaring records by using retention labels](/microsoft-365/compliance/declare-records)
+
+CSOM methods are available to apply (set) a retention label (ComplianceTag) on one or many items (ListItems) in SharePoint. Retention labels can be applied using this method without being published to the ___location by an existing label policy. 
+
+> [!IMPORTANT]
+> Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
+
+## SetComplianceTagOnBulkItems
+
+This method can be used to set a ComplianceTag on one or many ListItems. It is strongly recommended to use this method for this purpose.
+
+```c#
+public List<int> SetComplianceTagOnBulkItems( 
+             List<int> itemIds, 
+             string listUrl, 
+             string complianceTagValue)
+```
+
+### Parameters
+
+- 'List' [Int](/en-us/dotnet/api/system.int32)
+- 'ItemsIds' [String](/dotnet/api/system.string)
+- 'ListURL' [String](/dotnet/api/system.string)
+- 'ComplianceTagValue' [String](/dotnet/api/system.string)
+
+Attribute [RemoteAttribute](/dotnet/api/microsoft.sharepoint.client.remoteattribute)
+
+### Applies to
+
+|Product|Versions|
+|:---|:---|
+|SharePoint CSOM|latest|
+
+## Other
+
+> [!NOTE] 
+> It is strongly recommended to use SetComplianceTagOnBulkItems instead of these methods.
+
+The following methods are also available, but are no longer updated and may be subject to deprecation in the future. If you are using these methods, we strongly recommend use of the SetComplianceTagOnBulkItems method instead.
+
+* [SetComplianceTag](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetag)
+* [SetComplianceTagWithExplicitMetaInfo](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetagwithexplicitmetasupdate)
+* [SetComplianceTagWithExplicitMetasUpdate](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetagwithexplicitmetasupdate)
+* [SetComplianceTagWithHold](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetagwithhold)
+* [SetComplianceTagWithMetaInfo](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetagwithmetainfo)
+* [SetComplianceTagWithNoHold](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetagwithnohold)
+* [SetComplianceTagWithRecord](/dotnet/api/microsoft.sharepoint.client.listitem.setcompliancetagwithrecord)

docs/toc.yml

@@ -2083,6 +2083,8 @@
     href: apis/sharepoint-rest-graph.md
   - name: Application Lifecycle Management (ALM) APIs
     href: apis/alm-api-for-spfx-add-ins.md
+  - name: CSOM methods for applying retention labels
+    href: apis/csom-methods-for-applying-retention-labels.md    
   - name: SharePoint Add-in Management APIs
     href: apis/addin-management-apis.md
   - name: Microsoft 365 Copy and Move API