この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

ContentVersion

Salesforce CRM Content のドキュメントまたは Salesforce Files の特定のバージョンを表します。Salesforce CRM Content ドキュメントでは、バージョン 17.0 以降でこのオブジェクトを使用できます。Salesforce Files では、バージョン 20.0 以降でこのオブジェクトを使用できます。

24 時間に公開できるバージョンの最大数は 200,000 です。

注意: ファイルの共有方法によっては、ID を指定せずに ContentDocument および ContentVersion を照会すると、ユーザがアクセスできる一部のファイルが返されません。たとえば、ユーザに 1 つのファイルへのアクセス権のみがあるとします。そのファイルを共有しているレコードへのアクセス権があるためです。この場合、「SELECT Id FROM ContentDocument」のようなクエリでは、このファイルは返されません。

サポートされているコール

create()、describeLayout()、describeSObjects()、query()、retrieve()、search()、update()、upsert()

特別なアクセスルール

コンテンツ機能のライセンスを持つすべてのユーザは、個人ライブラリでバージョンを作成できます。カスタマーポータルユーザおよびパートナーポータルユーザは、要求で Experience Cloud サイトの NetworkId も指定する必要があります。
デフォルトでは、ユーザ (「すべてのデータの参照」権限を持つユーザを含む) は、自分がアクセス権を持つファイルに対してのみクエリを実行できます。たとえば、次のファイルです。
- ライブラリの権限に関係なく、自分の個人ライブラリおよび自分がメンバーであるライブラリ内の Salesforce Files (API バージョン 17.0 以降)。
- 自分が所有しているか、直接共有しているか、プロファイルに投稿したか、参照可能なグループに投稿した Salesforce Files (API バージョン 21.0 以降)。
「すべてのファイルのクエリ」権限を有効にすると、「すべてのデータの参照」権限のあるユーザは、ファイルのクエリに関する制限をスキップできます。
- 「すべてのファイルのクエリ」権限では、すべてのファイル (非メンバーライブラリのファイルやリストに記載しないグループのファイルを含む) が返されます。
- ユーザはアクセス権のないファイルを編集または削除したり、その新しいバージョンをアップロードしたりできません。
- 「すべてのファイルのクエリ」を有効にするには、「すべてのデータの参照」権限が必要です。
すべてのユーザは、自身の個人ライブラリでバージョンを更新できます。
ライブラリの権限に関係なく、ライブラリのメンバーであれば、バージョンまたはドキュメントの所有者はドキュメントを更新できます。
Salesforce CRM Content ドキュメントを更新するには、ユーザは次のライブラリ権限が有効なライブラリのメンバーである必要があります。
- コンテンツの追加
- コンテンツの代理追加
- ライブラリの管理
カスタマーポータルユーザおよびパートナーポータルユーザが、アクセス権を持つライブラリのコンテンツを照会するには、「ポータルのコンテンツの参照」権限が必要です。
カスタマーポータルユーザ、およびパートナーポータルユーザは、Salesforce CRM Content 機能のライセンスを持っている場合にのみ、ドキュメントの公開、バージョン作成、編集を実行できます。
FileType は、リンクの ContentUrl またはドキュメントの PathOnClient のいずれかで定義されます。
API バージョン 34.0 以降では、ファイルが Chatter からであるか Salesforce CRM Content からであるかに関わらず、任意のファイルをライブラリと共有できます。
API バージョン 39.0 以降では、ドキュメントへのアクセスを制御可能なカスタム Apex ダウンロードハンドラを作成できます。詳細は、『Apex コード開発者ガイド』を参照してください。

項目

項目	詳細
Checksum	型 string プロパティ Filter、Group、Nillable、Sort 説明ファイルの MD5 チェックサム。
ContentBodyId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明アップロードされているファイル Blob とは関係なく、ファイルバージョンを挿入できます。この項目は、クエリと挿入でのみ使用できます。ContentBody レコードのみを参照できます。この項目は、API バージョン 40.0 以降で使用できます。これはリレーション項目です。リレーション名 ContentBody リレーション種別 Lookup 参照先 ContentBody
ContentDocumentId	型 reference プロパティ Create、Filter、Group、Sort 説明ドキュメントの ID。これはリレーション項目です。リレーション名 ContentDocument リレーション種別 Lookup 参照先 ContentDocument
ContentLocation	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Restricted picklist、Sort 説明ドキュメントの発生源。有効な値は、次のとおりです。 S — ドキュメントは Salesforce 内にあります。表示ラベルは Salesforce です。 E — ドキュメントは Salesforce 外にあります。表示ラベルは External です。 L — ドキュメントはソーシャルネットワークにあり、ソーシャルカスタマーサービスを使用してアクセスします。表示ラベルは [ソーシャルカスタマーサービス] です。
ContentModifiedById	型 reference プロパティ Filter、Group、Nillable、Sort 説明ドキュメントを変更したユーザの ID。これはリレーション項目です。リレーション名 ContentModifiedBy リレーション種別 Lookup 参照先 User
ContentModifiedDate	型 dateTime プロパティ Create、Filter、Nillable、Sort 説明ドキュメントが変更された日付。 ContentModifiedDate は、ドキュメントの名前が変更されたり、新規ドキュメントバージョンがアップロードされたりした場合などに更新されます。ドキュメントの最初のバージョンをアップロードするとき、ContentModifiedDate は現在時刻または過去の任意の時刻に設定できます。
ContentSize	型 int プロパティ Filter、Group、Nillable、Sort 説明ドキュメントのサイズ (バイト単位)。リンクについては常に 0 です。
ContentUrl	型 url プロパティ Create、Filter、Nillable、Sort、Update 説明リンクの URL。リンクに対してのみ設定されます。FileType を決定する項目の 1 つ。API バージョン 33.0 以降の文字数制限は 1,300 文字です。API バージョン 32.0 以前の文字数制限は 255 文字です。
Description	型 textarea プロパティ Create、Filter、Nillable、Sort、Update 説明コンテンツバージョンの説明。
Division	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Restricted picklist、Sort、Update 説明組織のデータの論理セグメントです。たとえば、会社がさまざまな事業単位によって構成されている場合、「北米」、「ヘルスケア」、「コンサルティグ」など、各事業単位のディビジョンを作成することができます。組織でディビジョン権限が有効化されている場合にのみ使用可能です。
ExternalDataSourceId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 ExternalDataSource オブジェクトで参照される外部ドキュメントの ID。これはリレーション項目です。リレーション名 ExternalDataSource リレーション種別 Lookup 参照先 ExternalDataSource
ExternalDocumentInfo1	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明ファイルの URL を外部コンテンツリポジトリに保存します。外部供給元からのインテグレーションによってこの文字列のコンテンツが決まります。参照またはコピーが作成された後、次の操作を行うと外部ファイルの URL が更新されます。ファイル参照を Lightning Experience に再公開する。ドキュメントを開く。 reuseReference が true に設定された Connect REST API でファイル参照を作成する。ファイルが更新されると、共有リンクが最新バージョンに更新されます。
ExternalDocumentInfo2	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明外部ファイル ID が含まれます。この文字列のコンテンツは Salesforce によって決定され、非公開です。コンテンツは、外部システムに応じて通知なく変更されることが��ります。ファイル参照の作成後は、ファイルパスが変更されてもこの項目は更新されません。
FeaturedContentBoost	型 int プロパティ Filter、Group、Nillable、Sort 説明参照のみ。ドキュメントを「主要」としてマークします。
FeaturedContentDate	型 date プロパティ Filter、Group、Nillable、Sort 説明主要ドキュメントに指定された日付。
FileExtension	型 string プロパティ Filter、Group、Nillable、Sort 説明ドキュメントのファイル拡張子。この項目は、API バージョン 31.0 以降で使用できます。
FileType	型 string プロパティ Filter、Group、Sort 説明リンクの ContentUrl またはドキュメントの PathOnClient によって指定されたコンテンツの種類。
FirstPublishLocationId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明バージョンが最初に公開された場所の ID。バージョンが最初にユーザの個人ライブラリまたは [私のファイル] に公開された場合、項目には個人ライブラリまたは [私のファイル] を所有するユーザの ID が入力されます。Lightning Experience では、バージョンが最初に公開ライブラリに公開された場合、項目にはそのライブラリの ID が入力されます。 ContentDocumentLink でサポートされるすべて (レコードやグループなど、ファイルを添付できるものすべて) のレコード ID を受け入れます。 FirstPublishLocationId を設定すると、ファイルを作成して、それを 1 つのトランザクション内の初期レコード/グループと共有できます。また、オプションとして、後で追加のリンクを作成してファイルを他のレコードやグループと共有することもできます。ファイルは、作成されると自動的にレコードにリンクされ、PublishStatus が Pending/Personal から Public に変わります。この項目は、API を介してバージョンが最初に公開されたときにのみ設定されます。新しいコンテンツバージョンが挿入されたときに、FirstPublishLocationId を別の ID に設定することはできません。新しい OwnerId が ContentVersion に追加されると、Salesforce は FirstPublishLocationId を自動的に更新します。たとえば、公開する新しいバージョンの OwnerId が現在の OwnerId と異なるときは、以前のすべてのバージョンの FirstPublishLocationId が以前の OwnerId に更新されます。公開された新しいバージョンでは、FirstPublishLocationId が新しい OwnerId に設定されます。メモこれは多態的なリレーション項目です。リレーション名 FirstPublishLocation リレーション種別 Lookup 参照先 Account、Accreditation、ActivationTarget、ActivationTrgtIntOrgAccess、ApiAnomalyEventStore、AssessmentIndicatorDefinition、AssessmentTask、AssessmentTaskContentDocument、AssessmentTaskDefinition、AssessmentTaskIndDefinition、AssessmentTaskOrder、Asset、AssetRelationship、AssignedResource、Award、BoardCertification、BusinessLicense、BusinessMilestone、BusinessProfile、Campaign、CareBarrier、CareBarrierDeterminant、CareBarrierType、CareDeterminant、CareDeterminantType、CareDiagnosis、CareInterventionType、CareMetricTarget、CareObservation、CareObservationComponent、CarePgmProvHealthcareProvider、CarePreauth、CarePreauthItem、CareProgram、CareProgramCampaign、CareProgramEligibilityRule、CareProgramEnrollee、CareProgramEnrolleeProduct、CareProgramEnrollmentCard、CareProgramGoal、CareProgramProduct、CareProgramProvider、CareProgramTeamMember、CareProviderAdverseAction、CareProviderFacilitySpecialty、CareProviderSearchableField、CareRegisteredDevice、CareRequest、CareRequestDrug、CareRequestExtension、CareRequestItem、CareSpecialty、CareSpecialtyTaxonomy、CareTaxonomy、Case、CodeSet、CollaborationGroup、CommSubscription、CommSubscriptionChannelType、CommSubscriptionConsent、CommSubscriptionTiming、ConsumptionSchedule、Contact、ContactEncounter、ContactEncounterParticipant、ContentWorkspace、Contract、ConversationEntry、CoverageBenefit、CoverageBenefitItem、CredentialStuffingEventStore、CreditMemo、CreditMemoLine、Dashboard、DashboardComponent、DataStream、DelegatedAccount、DocumentChecklistItem、EmailMessage、EmailTemplate、EngagementChannelType、EnhancedLetterhead、EnrollmentEligibilityCriteria、Event、HealthcareFacility、HealthcareFacilityNetwork、HealthcarePayerNetwork、HealthcarePractitionerFacility、HealthcareProvider、HealthcareProviderNpi、HealthcareProviderSpecialty、HealthcareProviderTaxonomy、Identifier、Image、IndividualApplication、Invoice、InvoiceLine、Lead、ListEmail、Location、MarketSegment、MarketSegmentActivation、MemberPlan、MessagingSession、MktCalculatedInsight、OperatingHours、Opportunity、Order、OrderItem、Organization、OtherComponentTask、OutgoingEmail、PartyConsent、PersonEducation、PersonLanguage、PersonLifeEvent、PersonName、PlanBenefit、PlanBenefitItem、Product2、ProductFulfillmentLocation、ProductItem、ProductItemTransaction、ProductRequest、ProductRequestLineItem、ProductRequired、ProductTransfer、ProfileSkill、ProfileSkillEndorsement、ProfileSkillUser、ProviderSearchSyncLog、PurchaserPlan、PurchaserPlanAssn、ReceivedDocument、Report、ReportAnomalyEventStore、ResourceAbsence、ResourcePreference、ReturnOrder、ReturnOrderLineItem、ServiceAppointment、ServiceResource、ServiceResourceSkill、ServiceTerritory、ServiceTerritoryMember、ServiceTerritoryWorkType、SessionHijackingEventStore、Shift、Shipment、ShipmentItem、Site、SkillRequirement、SocialPost、Solution、Task、ThreatDetectionFeedback、Topic、User、Visit、VisitedParty、Visitor、VoiceCall、VolunteerProject、WorkBadgeDefinition、WorkOrder、WorkOrderLineItem、WorkType、WorkTypeGroup、WorkTypeGroupMember
IsAssetEnabled	型 boolean プロパティ Create、Group、Defaulted on create 説明 ContentVersion の挿入時に指定すると、ContentDocument ファイルを自動的に ContentAsset に変換できます。この項目には SOQL クエリを実行できますが、編集できません。この項目は、API バージョン 38.0 以降で使用できます。
IsEncrypted	この情報は、従来の暗号化ではなく Shield プラットフォームの暗号化について書かれています。メモ型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明ファイルが Shield プラットフォームの暗号化を使用して暗号化されているか (`true`)、否か (`false`) を示します。この項目は、API バージョン 34.0 以降で使用できます。
IsLatest	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明最新バージョンのドキュメントか (`true`)、否か (`false`) を示します。
IsMajorVersion	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明ドキュメントがメジャーバージョンの場合は `true`、ドキュメントが��イナーバージョンの場合は `false`。メジャーバージョンを置き換えることはできません。
Language	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明ドキュメントの言語。複数言語設定が有効になっていない場合、この項目はデフォルトで組織のデフォルト言語に設定されます。返されるラベルの言語を指定します。値は、`de_DE`、`en_GB` など有効なユーザロケール (言語および国) である必要があります。ロケールについての詳細は、CategoryNodeLocalization オブジェクトの Language 項目を参照してください。
NegativeRatingCount	型 int プロパティ Filter、Group、Nillable、Sort 説明参照のみ。異なるユーザがドキュメントに反対投票した回数。最新バージョンの評価数は、バージョンに個別のものではありません。バージョン 1 が 10 件の反対投票を受け、バージョン 2 が 2 件の反対投票を受けた場合、バージョン 2 の NegativeRatingCount は 12 となります。ただし、評価数は、過去のバージョンに対し影響はありません。バージョン 1 の NegativeRatingCount は 10 となります。
NetworkId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明このファイルが作成された Experience Cloud サイトの ID。組織でデジタルエクスペリエンスが有効化されている場合、この項目は API バージョン 26.0 以降で使用できます。 NetworkId は、ファイルの作成時にのみ追加できます。既存のファイルの場合、NetworkId の変更や追加はできません。
Origin	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Restricted picklist、Sort 説明コンテンツのバージョンの供給元。有効な値は、次のとおりです。 C — ユーザの個人ライブラリからのコンテンツドキュメント。表示ラベルは Content です。FirstPublishLocationId はユーザの ID である必要があります。FirstPublishLocationId が空白のままである場合は、デフォルトはユーザの ID になります。 H — ユーザの [私のファイル] の Salesforce ファイル。表示ラベルは Chatter です。FirstPublishLocationId はユーザの ID である必要があります。FirstPublishLocationId が空白のままである場合は、デフォルトはユーザの ID になります。組織で Chatter が有効である場合は、Origin は H のみに設定できます。この項目のデフォルトは C です。表示ラベルは Content Origin です。
OwnerId	型 reference プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明このドキュメントの所有者の ID。これはリレーション項目です。リレーション名 Owner リレーション種別 Lookup 参照先 User
PathOnClient	型 string プロパティ Create、Filter、Nillable、Sort 説明ドキュメントの完全パス。FileType を決定する項目の 1 つ。ドキュメントを [プレビュー] タブに表示するには、パスの拡張子を含む完全パスを指定します。メモ
PositiveRatingCount	型 int プロパティ Filter、Group、Nillable、Sort 説明参照のみ。異なるユーザがドキュメントに賛成投票した回数。最新バージョンの評価数は、バージョンに個別のものではありません。バージョン 1 が 10 件の賛成投票を受け、バージョン 2 が 2 件の賛成投票を受けた場合、バージョン 2 の PositiveRatingCount は 12 となります。ただし、評価数は、過去のバージョンに対し影響はありません。バージョン 1 の PositiveRatingCount は 10 となります。
PublishStatus	型 picklist プロパティ Defaulted on create、Filter、Group、Restricted picklist、Sort 説明ドキュメントが公開されているかどうか、そしてその公開方法を示します。有効な値は、次のとおりです。 `P` — ドキュメントは公開ライブラリに公開され、他のユーザも参照できます。表示ラベルは Public です。 `R` — ドキュメントは個人ライブラリに公開され、他のユーザは参照できません。表示ラベルは Personal Library です。 `U` — 公開が中断された��め、ドキュメントは公開されません。表示ラベルは Upload Interrupted です。
RatingCount	型 int プロパティ Filter、Group、Nillable、Sort 説明参照のみ。賛成の評価数と反対の評価数の合��。
ReasonForChange	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明ドキュメントが変更された理由。新しいバージョン (修正) ドキュメントを挿入する場合にのみ、この項目を設定できます。
RecordTypeId	型 reference プロパティ Create、Filter、Nillable、Update 説明バージョンのレコードタイプの ID。カスタム項目は RecordTypeId で制限されます。管理者が API を使用してカスタム項目を作成する場合、少なくとも 1 つのページレイアウトに追加する必要があります。カスタム項目を「一般情報」レコードタイプに関連付けられたページレイアウトに追加する場合、そのレコードタイプに対応する RecordTypeId は、該当のバージョンのレコードに設定する必要はありません。カスタム項目をカスタムレコードタイプに関連付けられたページレイアウトに追加する場合、そのレコードタイプに対応する RecordTypeId を該当のバージョンのレコードに設定する必要があります。
SharingOption	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Restricted picklist、Sort、Update 説明ファイルの共有が凍結されるかどうかを制御します。ファイルに対する「コラボレータ」アクセス権のあるシステム管理者とファイル所有者のみが、この項目を変更できます。デフォルトは Allowed で、新しい共有が可能であることを意味します。Restricted に設定されているときは新しい共有が阻止されますが、既存の共有には影響ありません。この項目は、API バージョン 35.0 以降で使用できます。
SharingPrivacy	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Restricted picklist、Sort、Update 説明ファイルの共有プライバシーを制御します。ファイルに対する「コラボレータ」アクセス権のあるシステム管理者とファイル所有者のみが、この項目を変更できます。デフォルトは [レコードへのアクセス権を持つすべてのユーザが参照可能] です。[レコードで非公開] に設定された場合、ファイルはレコードで非公開になりますが、他のユーザと選択的に共有できます。この項目は、API バージョン 41.0 以降で使用できます。
TagCsv	型 textarea プロパティ Create、Nillable、Sort、Update 説明 API によってタグをコンテンツのバージョンに適用するために使用するテキスト。
TextPreview	型 string プロパティ Nillable、Filter、Group、Sort 説明ドキュメントのプレビュー。API バージョン 35.0 以降で利用できます。
Title	型 string プロパティ Create、Filter、Group、idLookup、Sort、Update 説明ドキュメントのタイトル。
VersionData	型 base64 プロパティ Create、Nillable、Update 説明メモのコンテンツまたは本文。適切な形式の HTML またはプレーンテキストを含めることができます。API を使用してドキュメントをアップロードまたはダウンロードすると、ドキュメントは base64 で符号化 (アップロード) または複合化 (ダウンロード) されます。Content 項目のプレーンテキスト内の特殊文字はエスケープする必要があります。`content.escapeHtml4()` をコールすることによって特殊文字をエスケープできます。この項目はリンクには設定できません。 SOAP API を使用してアップロードできるファイルの最大サイズは 50 MB です。ドキュメントが API を使用してアップロードまたはダウンロードされると、base64 に変換され、VersionData に格納されます。この変換により、ドキュメントサイズは約 37% 増加します。アップロードする予定のファイルが変換後に 50 MB 未満になるように base64 変換による増加を考慮します。カスタム Apex ダウンロードハンドラが有効で、この項目が API を介してアクセスされ、ダウンロードが許可されていない場合、Salesforce は `CONTENT_CUSTOMIZED_DOWNLOAD_EXCEPTION` エラーを返します。
VersionNumber	型 string プロパティ Filter、Group、Nillable、Sort 説明バージョン番号。たとえば、1、2、3 のように、ドキュメントのバージョン番号が増加します。

使用方法

このオブジェクトを使用して、Salesforce CRM Content ドキュメントまたは Salesforce ファイルの特定バージョンを作成、クエリ、取得、検索、編集、更新します。ContentDocument オブジェクトを使用して、ライブラリのドキュメント (コンテンツパックを除く) または Salesforce ファイルの最新バージョンを取得、クエリ、更新、削除します。
このオブジェクトを使用して、Salesforce ファイルの特定バージョンを作成、クエリ、取得、検索、編集および更新します。ContentDocument オブジェクトを使用して、Salesforce ファイルの最新バージョンを取得、クエリ、更新、削除します。
レコードとのみ共有されているファイルを照会するには、ファイルのコンテンツ ID を指定する必要があります。
Salesforce Files にすべての項目を設定できるわけではありません。
最新バージョンで公開されている場合にのみ、バージョンを更新できます。
バージョンをアーカイブすることはできません。
API バージョン 32.0 以降では、バージョンのレコードタイプを更新できます。
API を使用してバージョンを削除することはできません。
SOAP API を使用してアップロードできるファイルの最大サイズは 50 MB です。ドキュメントが API を使用してアップロードまたはダウンロードされると、base64 に変換され、VersionData に格納されます。この変換により、ドキュメントサイズは約 37% 増加します。アップロードする予定のファイルが変換後に 50 MB 未満になるように base64 変換による増加を考慮します。
API を使用してドキュメントをダウンロードするには、ドキュメントの VersionData をエクスポートする必要があります。これにより、ダウンロード数は増えません。
データローダを使用してドキュメントをローカルドライブからアップロードする場合、VersionData および PathOnClient で実際のパスを指定する必要があります。VersionData は場所を示し、形式を抽出します。PathOnClient はアップロードされるドキュメントの種類を示します。
ContentVersion オブジェクトに対する SOQL クエリではドキュメントのすべてのバージョンを返します。ContentVersion オブジェクトに対する SOSL 検索ではドキュメントの最新のバージョンを返します。
API でバージョンを照会する場合、Upload Interrupted の PublishStatus を指定したバージョンは返されません。
個人ライブラリに公開されたドキュメントは、ドキュメントを公開したユーザのユーザプロファイルで設定されているデフォルト (ユーザプロファイルでデフォルトが設定されていない場合は一般情報) のレコードタイプを想定しています。
管理者は、デフォルトの (コンテンツバージョンレイアウト) ページレイアウトの名前を変更できます。
メモ
Contact Manager Edition、Group Edition、Professional Edition、Enterprise Edition、Unlimited Edition、および Performance Edition を使用するお客様は、24 時間につき最大で 200,000 件の新しいバージョンを公開できます。Developer Edition とトライアル版のお客様は、24 時間につき最大で 2,500 件の新しいバージョンを公開できます。
カスタム入力規則を使用すると、API を使用して個人ライブラリに公開されたドキュメントの更新ができなくなります。

ContentVersion レコードへのタグの適用

Enterprise API または Partner API を使用して、タグを ContentVersion レコードに適用できます。

タグを ContentVersion レコードに適用するには、TagCsv 項目で値を設定します。たとえば、この項目を one,two,three に設定すると、そのバージョンに 3 つのタグが作成され、関連付けられます。

TagCsv 項目の最大長は、2,000 文字です。
各タグの最大長は、100 文字です。
タグがバージョンに適用されると、コンテンツには自動的にインデックスが付けられ、タグが検索可能になります。
個人ライブラリに公開されている TagCsv にタグを適用することはできません。
ContentDocument オブジェクトを使用してタグを適用できません。
タグ名は変更や削除はできません。ドキュメントからタグを除外することはできますが、タグは削除されません。
タグでは、大文字と小文字は区別されません。大文字と小文字を変えたとしても、2 つのタグに同じ名前を付けることはできません。元のタグの大文字と小文字が常に使用されます。

ContentVersion レコードからタグを削除するには、標準の API 更新を実行し、削除する TagCsv 項目から値を削除します。たとえば、元の TagCsv が one,two,three である場合、TagCsv 項目で one,three を指定して API 更新を実行すると、two が削除されます。ContentVersion からすべてのタグを削除するには、項目を null に設定して、標準の API 更新を実行します。

ContentVersion レコードを作成し、API を使用して修正する場合、別の ContentVersion レコードを挿入しますが、元のものと同じ ContentDocument レコードと関連付けます。これにより、タギングに次のような影響を与えます。

TagCsv 項目で修正を追加し、値を設定しない場合、以前のバージョンに適用されたすべてのタグが自動的に新しいバージョンに適用されます。
修正を加えて新しい TagCsv 項目を指定する場合、タグは移行せず、指定したタグが代わりに適用されます。

ContentVersion レコードに SOQL クエリを実行して、TagCsv 項目を選択すると、そのレコードに関連付けられたすべてのタグが返されます。文字列のタグは、異なる順序で挿入された場合でも、アルファベット順に並びます。TagCsv 項目は、SOQL クエリの条件の一部として使用することはできません。組織内のすべてのタグにクエリを実行できるわけではありません。

ライブラリのタギングルール:

API によるタギングでは、ドキュメントが公開されているライブラリのタギング制限が適用されます。たとえば、ライブラリが制限タギングモードで、タグ one,three のみを使用できる場合、one,two,three の TagCsv のバージョンは保存できません。
ライブラリがガイド付きタギングモードの場合、タグを ContentVersion に適用できます。ライブラリではガイド付きタグの値を照会することはできませんが、ライブラリのタギングモデルを照会することは可能です。

Salesforce プラットフォームのオブジェクトリファレンス

ContentVersion

サポートされているコール

特別なアクセスルール

項目

使用方法

ContentVersion レコードへのタグの適用

関連付けられたオブジェクト

Salesforce プラットフォームのオブジェクトリファレンス

ContentVersion

サポートされているコール

特別なアクセスルール

項目

使用方法

ContentVersion レコードへのタグの適用

関連付けられたオブジェクト

関連項目: