Catalog - Publish Draft Item
Initiates a publish of an item from the working catalog to the public catalog. You can use the GetItemPublishStatus API to track the state of the item publish.
POST https://titleId.playfabapi.com/Catalog/PublishDraftItem
Request Header
Name | Required | Type | Description |
---|---|---|---|
X-EntityToken | True |
string |
This API requires an Entity Session Token, available from the Entity GetEntityToken method. |
Request Body
Name | Type | Description |
---|---|---|
AlternateId |
An alternate ID associated with this item. |
|
CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
ETag |
string |
ETag of the catalog item to published from the working catalog to the public catalog. Used for optimistic concurrency. If the provided ETag does not match the ETag in the current working catalog, the request will be rejected. If not provided, the current version of the document in the working catalog will be published. |
Entity |
The entity to perform this action on. |
|
Id |
string |
The unique ID of the item. |
Responses
Name | Type | Description |
---|---|---|
200 OK | ||
400 Bad Request |
This is the outer wrapper for all responses with errors |
Security
X-EntityToken
This API requires an Entity Session Token, available from the Entity GetEntityToken method.
Type:
apiKey
In:
header
Definitions
Name | Description |
---|---|
Api |
The basic wrapper around every failed API response |
Catalog |
|
Entity |
Combined entity type and ID structure which uniquely identifies a single entity. |
Publish |
The call kicks off a workflow to publish the item to the public catalog. The Publish Status API should be used to monitor the publish job. |
Publish |
ApiErrorWrapper
The basic wrapper around every failed API response
Name | Type | Description |
---|---|---|
code |
integer |
Numerical HTTP code |
error |
string |
Playfab error code |
errorCode |
integer |
Numerical PlayFab error code |
errorDetails |
object |
Detailed description of individual issues with the request object |
errorMessage |
string |
Description for the PlayFab errorCode |
status |
string |
String HTTP code |
CatalogAlternateId
Name | Type | Description |
---|---|---|
Type |
string |
Type of the alternate ID. |
Value |
string |
Value of the alternate ID. |
EntityKey
Combined entity type and ID structure which uniquely identifies a single entity.
Name | Type | Description |
---|---|---|
Id |
string |
Unique ID of the entity. |
Type |
string |
Entity type. See https://docs.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types |
PublishDraftItemRequest
The call kicks off a workflow to publish the item to the public catalog. The Publish Status API should be used to monitor the publish job.
Name | Type | Description |
---|---|---|
AlternateId |
An alternate ID associated with this item. |
|
CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
ETag |
string |
ETag of the catalog item to published from the working catalog to the public catalog. Used for optimistic concurrency. If the provided ETag does not match the ETag in the current working catalog, the request will be rejected. If not provided, the current version of the document in the working catalog will be published. |
Entity |
The entity to perform this action on. |
|
Id |
string |
The unique ID of the item. |
PublishDraftItemResponse
Error Codes
Name | Code |
---|---|
DatabaseThroughputExceeded | 1113 |
ItemNotFound | 1047 |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기