> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 服務 C API 概觀 - PFCatalog.h

> 服務 C API 概觀 - PFCatalog.h

## 函式

| 函式 | 說明 |
| - | - |
| [PFCatalogCreateDraftItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogcreatedraftitemasync) | 使用提供的中繼資料在工作目錄中建立新項目。注意：提供的 SAS 權杖有效期為 1 小時。 |
| [PFCatalogCreateDraftItemGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogcreatedraftitemgetresult) | 取得成功的 PFCatalogCreateDraftItemAsync 呼叫的結果。 |
| [PFCatalogCreateDraftItemGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogcreatedraftitemgetresultsize) | 取得儲存 CreateDraftItem 呼叫結果所需的位元組大小。 |
| [PFCatalogCreateUploadUrlsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogcreateuploadurlsasync) | 建立一或多個上傳 URL，用戶端可用來上傳原始檔案資料。如果內容 URL 和上傳的內容未附加至草稿或已發佈的項目，將在 24 小時後被垃圾收集。如需上傳內容的詳細定價資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/pricing/meters/catalog-meters](https://learn.microsoft.com/gaming/playfab/features/pricing/meters/catalog-meters) |
| [PFCatalogCreateUploadUrlsGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogcreateuploadurlsgetresult) | 取得成功的 PFCatalogCreateUploadUrlsAsync 呼叫的結果。 |
| [PFCatalogCreateUploadUrlsGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogcreateuploadurlsgetresultsize) | 取得儲存 CreateUploadUrls 呼叫結果所需的位元組大小。 |
| [PFCatalogDeleteEntityItemReviewsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogdeleteentityitemreviewsasync) | 刪除指定實體提交的所有評論、有用性投票和評分。 |
| [PFCatalogDeleteItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogdeleteitemasync) | 從工作目錄移除項目，並從公用目錄移除所有已發佈的版本。 |
| [PFCatalogGetCatalogConfigAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetcatalogconfigasync) | 取得目錄的組態。只有 Title 實體可以呼叫此 API。此 API 的限制為每 10 秒 100 個要求。如需目錄組態的詳細資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/economy-v2/settings](https://learn.microsoft.com/gaming/playfab/features/economy-v2/settings) |
| [PFCatalogGetCatalogConfigGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetcatalogconfiggetresult) | 取得成功的 PFCatalogGetCatalogConfigAsync 呼叫的結果。 |
| [PFCatalogGetCatalogConfigGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetcatalogconfiggetresultsize) | 取得儲存 GetCatalogConfig 呼叫結果所需的位元組大小。 |
| [PFCatalogGetDraftItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemasync) | 從工作目錄擷取項目。此項目代表該項目目前的工作狀態。GetDraftItem 不會使用目錄的快取，應在嘗試取得最新項目更新時使用。不過請注意，項目參考資料會被快取，變更可能需要一些時間才會傳播。注意：提供的 SAS 權杖有效期為 1 小時。 |
| [PFCatalogGetDraftItemGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemgetresult) | 取得成功的 PFCatalogGetDraftItemAsync 呼叫的結果。 |
| [PFCatalogGetDraftItemGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemgetresultsize) | 取得儲存 GetDraftItem 呼叫結果所需的位元組大小。 |
| [PFCatalogGetDraftItemsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemsasync) | 從草稿目錄擷取項目的分頁清單。單一要求最多可擷取 50 個識別碼。GetDraftItems 不會使用目錄的快取，應在嘗試取得最新項目更新時使用。注意：提供的 SAS 權杖有效期為 1 小時。 |
| [PFCatalogGetDraftItemsGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemsgetresult) | 取得成功的 PFCatalogGetDraftItemsAsync 呼叫的結果。 |
| [PFCatalogGetDraftItemsGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemsgetresultsize) | 取得儲存 GetDraftItems 呼叫結果所需的位元組大小。 |
| [PFCatalogGetEntityDraftItemsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentitydraftitemsasync) | 擷取由該實體所建立之草稿目錄項目的分頁清單。一次最多可傳回 50 個項目。您可以使用接續權杖，對傳回數量超過限制的結果進行分頁。GetEntityDraftItems 不會使用目錄的快取，應在嘗試取得最新項目更新時使用。 |
| [PFCatalogGetEntityDraftItemsGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentitydraftitemsgetresult) | 取得成功的 PFCatalogGetEntityDraftItemsAsync 呼叫的結果。 |
| [PFCatalogGetEntityDraftItemsGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentitydraftitemsgetresultsize) | 取得儲存 GetEntityDraftItems 呼叫結果所需的位元組大小。 |
| [PFCatalogGetEntityItemReviewAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentityitemreviewasync) | 取得已驗證實體對指定項目提交的評論。個別評分和評論資料會近乎即時更新，延遲在幾秒以內。 |
| [PFCatalogGetEntityItemReviewGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentityitemreviewgetresult) | 取得成功的 PFCatalogGetEntityItemReviewAsync 呼叫的結果。 |
| [PFCatalogGetEntityItemReviewGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentityitemreviewgetresultsize) | 取得儲存 GetEntityItemReview 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemasync) | 從公用目錄擷取項目。GetItem 不會使用目錄的快取，應在嘗試取得最新項目更新時使用。不過請注意，項目參考資料會被快取，變更可能需要一些時間才會傳播。 |
| [PFCatalogGetItemContainersAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemcontainersasync) | 搜尋指定的項目，並傳回包含該項目的一組套件組合和商店。一次最多可傳回 50 個項目。您可以使用接續權杖，對傳回數量超過限制的結果進行分頁。此 API 適用於工具/自動化案例，且 RPS 較低：Player 實體限制為每 300 秒 30 個要求，Title 實體限制為每 10 秒 100 個要求。 |
| [PFCatalogGetItemContainersGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemcontainersgetresult) | 取得成功的 PFCatalogGetItemContainersAsync 呼叫的結果。 |
| [PFCatalogGetItemContainersGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemcontainersgetresultsize) | 取得儲存 GetItemContainers 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemgetresult) | 取得成功的 PFCatalogGetItemAsync 呼叫的結果。 |
| [PFCatalogGetItemGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemgetresultsize) | 取得儲存 GetItem 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemModerationStateAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemmoderationstateasync) | 取得項目的審核狀態，包括疑慮類別和字串原因。如需審核狀態的詳細資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/economy-v2/ugc/moderation](https://learn.microsoft.com/gaming/playfab/features/economy-v2/ugc/moderation) |
| [PFCatalogGetItemModerationStateGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemmoderationstategetresult) | 取得成功的 PFCatalogGetItemModerationStateAsync 呼叫的結果。 |
| [PFCatalogGetItemModerationStateGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemmoderationstategetresultsize) | 取得儲存 GetItemModerationState 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemPublishStatusAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitempublishstatusasync) | 取得項目發佈的狀態。 |
| [PFCatalogGetItemPublishStatusGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitempublishstatusgetresult) | 取得成功的 PFCatalogGetItemPublishStatusAsync 呼叫的結果。 |
| [PFCatalogGetItemPublishStatusGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitempublishstatusgetresultsize) | 取得儲存 GetItemPublishStatus 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemReviewsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsasync) | 取得與指定項目相關聯的一組分頁評論。個別評分和評論資料會近乎即時更新，延遲在幾秒以內。 |
| [PFCatalogGetItemReviewsGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsgetresult) | 取得成功的 PFCatalogGetItemReviewsAsync 呼叫的結果。 |
| [PFCatalogGetItemReviewsGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsgetresultsize) | 取得儲存 GetItemReviews 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemReviewSummaryAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsummaryasync) | 取得與指定項目相關聯之所有評分和評論的摘要。摘要評分資料會被快取，更新資料會在 15 分鐘內送達。 |
| [PFCatalogGetItemReviewSummaryGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsummarygetresult) | 取得成功的 PFCatalogGetItemReviewSummaryAsync 呼叫的結果。 |
| [PFCatalogGetItemReviewSummaryGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsummarygetresultsize) | 取得儲存 GetItemReviewSummary 呼叫結果所需的位元組大小。 |
| [PFCatalogGetItemsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemsasync) | 從公用目錄擷取項目。一次最多可傳回 50 個項目。GetItems 不會使用目錄的快取，應在嘗試取得最新項目更新時使用。不過請注意，項目參考資料會被快取，變更可能需要一些時間才會傳播。 |
| [PFCatalogGetItemsGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemsgetresult) | 取得成功的 PFCatalogGetItemsAsync 呼叫的結果。 |
| [PFCatalogGetItemsGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemsgetresultsize) | 取得儲存 GetItems 呼叫結果所需的位元組大小。 |
| [PFCatalogPublishDraftItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogpublishdraftitemasync) | 起始將項目從工作目錄發佈至公用目錄。您可以使用 GetItemPublishStatus API 來追蹤項目發佈的狀態。 |
| [PFCatalogReportItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogreportitemasync) | 提交項目的檢舉，指出該項目不當之處。 |
| [PFCatalogReportItemReviewAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogreportitemreviewasync) | 提交評論的檢舉 |
| [PFCatalogReviewItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogreviewitemasync) | 建立或更新指定項目的評論。如需項目評分和評論相關快取的詳細資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/ratings#ratings-design-and-caching](https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/ratings#ratings-design-and-caching) |
| [PFCatalogSearchItemsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsasync) | 使用提供的搜尋參數對公用目錄執行搜尋，並傳回一組分頁結果。SearchItems 使用目錄的快取，項目更新最多可能需要幾分鐘才會傳播。若要立即取得最新的項目更新，應使用 GetItem API。如需 Search API 的詳細資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/search](https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/search) |
| [PFCatalogSearchItemsGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsgetresult) | 取得成功的 PFCatalogSearchItemsAsync 呼叫的結果。 |
| [PFCatalogSearchItemsGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsearchitemsgetresultsize) | 取得儲存 SearchItems 呼叫結果所需的位元組大小。 |
| [PFCatalogSetItemModerationStateAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsetitemmoderationstateasync) | 設定項目的審核狀態，包括疑慮類別和字串原因。如需審核狀態的詳細資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/economy-v2/ugc/moderation](https://learn.microsoft.com/gaming/playfab/features/economy-v2/ugc/moderation) |
| [PFCatalogSubmitItemReviewVoteAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogsubmititemreviewvoteasync) | 提交評論的投票，指出該評論是否有幫助。 |
| [PFCatalogTakedownItemReviewsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogtakedownitemreviewsasync) | 提交下架一或多則評論的要求。 |
| [PFCatalogUpdateCatalogConfigAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogupdatecatalogconfigasync) | 更新目錄的組態。只有 Title 實體可以呼叫此 API。此 API 的限制為每 10 秒 10 個要求。如需目錄組態的詳細資訊，請參閱：[https://learn.microsoft.com/gaming/playfab/features/economy-v2/settings](https://learn.microsoft.com/gaming/playfab/features/economy-v2/settings) |
| [PFCatalogUpdateDraftItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogupdatedraftitemasync) | 更新工作目錄中項目的中繼資料。注意：提供的 SAS 權杖有效期為 1 小時。 |
| [PFCatalogUpdateDraftItemGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogupdatedraftitemgetresult) | 取得成功的 PFCatalogUpdateDraftItemAsync 呼叫的結果。 |
| [PFCatalogUpdateDraftItemGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogupdatedraftitemgetresultsize) | 取得儲存 UpdateDraftItem 呼叫結果所需的位元組大小。 |


## Related topics

- [服務 C API 概觀 - PFCatalogTypes.h](/zh-TW/services/playfab/api-references/c/pfcatalogtypes/pfcatalogtypes_members.md)
- [概觀](/zh-TW/services/xbox-services/fundamentals/live-xbl-overview.md)
- [PFCatalogHelpfulnessVote](/zh-TW/services/playfab/api-references/c/pfcatalogtypes/enums/pfcataloghelpfulnessvote.md)
- [PFCatalogUpdateCatalogConfigAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogupdatecatalogconfigasync.md)
- [PFCatalogGetCatalogConfigAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetcatalogconfigasync.md)
