Display & Video 360 API

Display & Video 360 API v1 已淘汰。

Display & Video 360 API 可讓使用者自動化處理複雜的 Display & Video 360 工作流程，例如建立廣告訂單及為個別委刊項設定指定目標選項。

• REST 資源：v1.advertisers
• REST 資源：v1.advertisers.assets
• REST 資源：v1.advertisers.campaigns
• REST 資源： v1.advertisers.campaigns.targetingTypes.assignedTargetOptions
• REST 資源：v1.advertisers.channels
• REST 資源：v1.advertisers.channels.sites
• REST 資源：v1.advertisers.creatives
• REST 資源：v1.advertisers.insertionOrders
• REST 資源： v1.advertisers.insertionOrders.targetingTypes.assignedTargetOptions
• REST 資源：v1.advertisers.invoices
• REST 資源：v1.advertisers.lineItems
• REST 資源： v1.advertisers.lineItems.targetingTypes.assignedTargetOptions
• REST 資源：v1.advertisers.locationLists
• REST 資源：v1.advertisers.locationLists.assignedLocations
• REST 資源：v1.advertisers.manualTriggers
• REST 資源：v1.advertisers.ExcludeKeywordLists
• REST 資源：v1.advertisers.ExcludeKeywordLists.排除關鍵字
• REST 資源：v1.advertisers.targetingTypes.assignedTargetOptions
• REST 資源：v1.combinedAudiences
• REST 資源：v1.customBiddingAlgorithms
• REST 資源：v1.customBiddingAlgorithms.scripts
• REST 資源：v1.customLists
• REST 資源：v1.firstAndthirdPartyAudiences
• REST 資源：v1.gtaglightGroups
• REST 資源：v1.googleAudiences
• REST 資源：v1.sureOrders
• REST 資源：v1.inventorySourceGroups
• REST 資源：v1.inventorySourceGroups.assignedInventorySources
• REST 資源：v1.inventorySources
• REST 資源：v1.media
• REST 資源：v1.partners
• REST 資源：v1.partners.channels
• REST 資源：v1.partners.channels.sites
• REST 資源：v1.partners.targetingTypes.assignedTargetOptions
• REST 資源：v1.sdfdownloadtasks
• REST 資源：v1.sdfdownloadtasks.operations
• REST 資源：v1.targetingTypes.targetingOptions
• REST 資源：v1.users

服務：displayvideo.googleapis.com

如要呼叫這項服務，建議您使用 Google 提供的用戶端程式庫。如果應用程式需要使用您自己的程式庫來呼叫這項服務，請在提出 API 要求時使用下列資訊。

探索文件

探索文件是一種機器可解讀的規格，用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式，以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件：

• https://displayvideo.googleapis.com/$discovery/rest?version=v1

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點，且下方的 URI 皆以此服務端點為基準：

• https://displayvideo.googleapis.com

REST 資源：v1.advertisers

方法
audit	GET /v1/advertisers/{advertiserId}:audit 稽核廣告客戶。
bulkEditAdvertiserAssignedTargetingOptions	POST /v1/advertisers/{advertiserId}:bulkEditAdvertiserAssignedTargetingOptions 單一廣告客戶的大量編輯指定目標選項。
bulkListAdvertiserAssignedTargetingOptions	GET /v1/advertisers/{advertiserId}:bulkListAdvertiserAssignedTargetingOptions 根據各種指定類型，列出廣告客戶的指派指定目標選項。
create	POST /v1/advertisers 建立新的廣告客戶。
delete	DELETE /v1/advertisers/{advertiserId} 刪除廣告客戶。
get	GET /v1/advertisers/{advertiserId} 取得廣告客戶。
list	GET /v1/advertisers 列出目前使用者可存取的廣告主。
patch	PATCH /v1/advertisers/{advertiser.advertiserId} 更新現有的廣告客戶。

REST 資源：v1.advertisers.assets

方法
upload	POST /v1/advertisers/{advertiserId}/assets POST /upload/v1/advertisers/{advertiserId}/assets 上傳素材資源。

REST 資源：v1.advertisers.campaigns

方法
bulkListCampaignAssignedTargetingOptions	GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}:bulkListCampaignAssignedTargetingOptions 列出跨指定類型廣告活動的指派指定目標選項。
create	POST /v1/advertisers/{campaign.advertiserId}/campaigns 建立新的廣告活動。
delete	DELETE /v1/advertisers/{advertiserId}/campaigns/{campaignId} 永久刪除廣告活動。
get	GET /v1/advertisers/{advertiserId}/campaigns/{campaignId} 取得廣告活動。
list	GET /v1/advertisers/{advertiserId}/campaigns 列出廣告客戶中的廣告活動。
patch	PATCH /v1/advertisers/{campaign.advertiserId}/campaigns/{campaign.campaignId} 更新現有的廣告活動。

REST 資源：v1.advertisers.campaigns.targetingTypes.assignedTargetingOptions

方法
get	GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 為廣告活動指派一個指定目標選項。
list	GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions 列出指派給特定指定類型廣告活動的指定目標選項。

REST 資源：v1.advertisers.channels

方法
create	POST /v1/advertisers/{advertiserId}/channels 建立新頻道。
get	GET /v1/advertisers/{advertiserId}/channels/{channelId} 為合作夥伴或廣告客戶取得頻道。
list	GET /v1/advertisers/{advertiserId}/channels 列出合作夥伴或廣告客戶的管道。
patch	PATCH /v1/advertisers/{advertiserId}/channels/{channel.channelId} 更新頻道。

REST 資源：v1.advertisers.channels.sites

方法
bulkEdit	POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit 大量編輯單一管道下的網站。
create	POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites 在頻道中建立網站。
delete	DELETE /v1/advertisers/{advertiserId}/channels/{channelId}/sites/{urlOrAppId} 從頻道中刪除網站。
list	GET /v1/advertisers/{advertiserId}/channels/{channelId}/sites 列出管道中的網站。
replace	POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:replace 取代單一管道下的所有網站。

REST 資源：v1.advertisers.creatives

方法
create	POST /v1/advertisers/{creative.advertiserId}/creatives 建立新的廣告素材。
delete	DELETE /v1/advertisers/{advertiserId}/creatives/{creativeId} 刪除廣告素材。
get	GET /v1/advertisers/{advertiserId}/creatives/{creativeId} 取得廣告素材。
list	GET /v1/advertisers/{advertiserId}/creatives 列出廣告客戶中的廣告素材。
patch	PATCH /v1/advertisers/{creative.advertiserId}/creatives/{creative.creativeId} 更新現有廣告素材。

REST 資源：v1.advertisers.insertionOrders

方法
bulkListInsertionOrderAssignedTargetingOptions	GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:bulkListInsertionOrderAssignedTargetingOptions 根據各種指定類型，列出廣告訂單的指派指定目標選項。
create	POST /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders 建立新的廣告訂單。
delete	DELETE /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId} 刪除廣告訂單。
get	GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId} 取得廣告訂單。
list	GET /v1/advertisers/{advertiserId}/insertionOrders 列出廣告客戶的廣告訂單。
patch	PATCH /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId} 更新現有的廣告訂單。

REST 資源：v1.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

方法
get	GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 取得指派給廣告訂單的單一指定目標選項。
list	GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions 列出指派給廣告訂單的指定目標選項。

REST 資源：v1.advertisers.invoices

方法
list	GET /v1/advertisers/{advertiserId}/invoices 列出特定月份開立給廣告客戶的月結單。
lookupInvoiceCurrency	GET /v1/advertisers/{advertiserId}/invoices:lookupInvoiceCurrency 擷取廣告客戶在特定月份使用的月結單幣別。

REST 資源：v1.advertisers.lineItems

方法
bulkEditLineItemAssignedTargetingOptions	POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkEditLineItemAssignedTargetingOptions 單一委刊項中的大量編輯指定目標選項。
bulkListLineItemAssignedTargetingOptions	GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkListLineItemAssignedTargetingOptions 在各種指定類型中，列出委刊項的指派指定目標選項。
create	POST /v1/advertisers/{lineItem.advertiserId}/lineItems 建立新的委刊項。
delete	DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId} 刪除委刊項。
generateDefault	POST /v1/advertisers/{advertiserId}/lineItems:generateDefault 建立新委刊項，並沿用廣告訂單和ENTITY_STATUS_DRAFT entity_status 的設定 (包括指定目標)。
get	GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId} 取得委刊項。
list	GET /v1/advertisers/{advertiserId}/lineItems 列出廣告客戶中的委刊項。
patch	PATCH /v1/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId} 更新現有的委刊項。

REST 資源：v1.advertisers.lineItems.targetingTypes.assignedTargetingOptions

方法
create	POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions 為委刊項指派指定目標選項。
delete	DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 從委刊項刪除指派的指定目標選項。
get	GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 取得指派給委刊項的單一指定目標選項。
list	GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions 列出指派給委刊項的指定目標選項。

REST 資源：v1.advertisers.locationLists

方法
create	POST /v1/advertisers/{advertiserId}/locationLists 建立新的地點清單。
get	GET /v1/advertisers/{advertiserId}/locationLists/{locationListId} 取得位置清單。
list	GET /v1/advertisers/{advertiserId}/locationLists 根據特定廣告主 ID 列出位置清單。
patch	PATCH /v1/advertisers/{advertiserId}/locationLists/{locationList.locationListId} 更新位置清單。

REST 資源：v1.advertisers.locationLists.assignedLocations

方法
bulkEdit	POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations:bulkEdit 大量編輯地點與單一地點清單之間的多項指派項目。
create	POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations 在地點清單和地點清單之間建立指派作業。
delete	DELETE /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{assignedLocationId} 刪除位置與地點清單之間的指派作業。
list	GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations 列出指派給位置清單的地點。

REST 資源：v1.advertisers.manualTriggers

方法
activate	POST /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}:activate 啟用手動觸發條件。
create	POST /v1/advertisers/{manualTrigger.advertiserId}/manualTriggers 建立新的手動觸發條件。
deactivate	POST /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}:deactivate 停用手動觸發條件。
get	GET /v1/advertisers/{advertiserId}/manualTriggers/{triggerId} 取得手動觸發條件。
list	GET /v1/advertisers/{advertiserId}/manualTriggers 列出目前使用者可存取特定廣告主 ID 的手動觸發條件。
patch	PATCH /v1/advertisers/{manualTrigger.advertiserId}/manualTriggers/{manualTrigger.triggerId} 更新手動觸發條件。

REST 資源：v1.advertisers.negativeKeywordLists

方法
create	POST /v1/advertisers/{advertiserId}/negativeKeywordLists 建立新的排除關鍵字清單。
delete	DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId} 根據廣告主 ID 和排除關鍵字清單 ID，刪除排除關鍵字清單。
get	GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId} 根據廣告主 ID 和排除關鍵字清單 ID 取得排除關鍵字清單。
list	GET /v1/advertisers/{advertiserId}/negativeKeywordLists 根據特定廣告客戶 ID 列出排除關鍵字清單。
patch	PATCH /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordList.negativeKeywordListId} 更新排除關鍵字清單。

REST 資源：v1.advertisers.negativeKeywordLists.negativeKeywords。

方法
bulkEdit	POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit 大量編輯單一排除關鍵字清單中的排除關鍵字。
create	POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords 在排除關鍵字清單中建立排除關鍵字。
delete	DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords/{keywordValue} 從排除關鍵字清單中刪除排除關鍵字。
list	GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords 列出排除關鍵字清單中的排除關鍵字。
replace	POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:replace 取代單一排除關鍵字清單中的所有排除關鍵字。

REST 資源：v1.advertisers.targetingTypes.assignedTargetingOptions

方法
create	POST /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions 為廣告客戶指派指定目標選項。
delete	DELETE /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 從廣告客戶中刪除指派的指定目標選項。
get	GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 取得指派給廣告客戶的單一指定目標選項。
list	GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions 列出指派給廣告客戶的指定目標選項。

REST 資源：v1.combinedAudiences

方法
get	GET /v1/combinedAudiences/{combinedAudienceId} 取得合併目標對象。
list	GET /v1/combinedAudiences 列出合併目標對象。

REST 資源：v1.customBiddingAlgorithms

方法
create	POST /v1/customBiddingAlgorithms 建立新的自訂出價演算法。
get	GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId} 取得自訂出價演算法。
list	GET /v1/customBiddingAlgorithms 列出目前使用者可存取且可用於出價策略的自訂出價演算法。
patch	PATCH /v1/customBiddingAlgorithms/{customBiddingAlgorithm.customBiddingAlgorithmId} 更新現有的自訂出價演算法。
uploadScript	GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadScript 為指令碼檔案建立自訂出價指令碼參照物件。

REST 資源：v1.customBiddingAlgorithms.scripts

方法
create	POST /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts 建立新的自訂出價指令碼。
get	GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts/{customBiddingScriptId} 取得自訂出價指令碼。
list	GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts 列出屬於指定演算法的自訂出價指令碼。

REST 資源：v1.customLists

方法
get	GET /v1/customLists/{customListId} 取得自訂清單。
list	GET /v1/customLists 列出自訂名單。

REST 資源：v1.firstAndThirdPartyAudiences

方法
create	POST /v1/firstAndThirdPartyAudiences 建立 FirstAndthirdPartyAudience。
editCustomerMatchMembers	POST /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers 更新目標客戶比對目標對象的成員名單。
get	GET /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId} 取得第一方和第三方目標對象。
list	GET /v1/firstAndThirdPartyAudiences 列出第一方和第三方目標對象。
patch	PATCH /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId} 更新現有的 FirstAndthirdPartyAudience。

REST 資源：v1.floodlightGroups

方法
get	GET /v1/floodlightGroups/{floodlightGroupId} 取得 Floodlight 群組。
patch	PATCH /v1/floodlightGroups/{floodlightGroup.floodlightGroupId} 更新現有的 Floodlight 群組。

REST 資源：v1.googleAudiences

方法
get	GET /v1/googleAudiences/{googleAudienceId} 取得 Google 目標對象。
list	GET /v1/googleAudiences 列出 Google 目標對象。

REST 資源：v1.guaranteedOrders

方法
create	POST /v1/guaranteedOrders 建立新的保證訂單。
editGuaranteedOrderReadAccessors	POST /v1/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors 編輯保證訂單的已讀取廣告客戶資料。
get	GET /v1/guaranteedOrders/{guaranteedOrderId} 取得保證的訂單。
list	GET /v1/guaranteedOrders 列出目前使用者可存取的保證訂單。
patch	PATCH /v1/guaranteedOrders/{guaranteedOrder.guaranteedOrderId} 更新現有的保證訂單。

REST 資源：v1.inventorySourceGroups

方法
create	POST /v1/inventorySourceGroups 建立新的廣告空間來源群組。
delete	DELETE /v1/inventorySourceGroups/{inventorySourceGroupId} 刪除廣告空間來源群組。
get	GET /v1/inventorySourceGroups/{inventorySourceGroupId} 取得廣告空間來源群組。
list	GET /v1/inventorySourceGroups 列出目前使用者可存取的廣告空間來源群組。
patch	PATCH /v1/inventorySourceGroups/{inventorySourceGroup.inventorySourceGroupId} 更新廣告空間來源群組。

REST 資源：v1.inventorySourceGroups.assignedInventorySources

方法
bulkEdit	POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources:bulkEdit 大量編輯廣告空間來源與單一廣告空間來源群組之間的多項指派項目。
create	POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources 在廣告空間來源與廣告空間來源群組之間建立指派項目。
delete	DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources/{assignedInventorySourceId} 刪除廣告空間來源與廣告空間來源群組之間的指派項目。
list	GET /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources 列出指派給廣告空間來源群組的廣告空間來源。

REST 資源：v1.inventorySources

方法
create	POST /v1/inventorySources 建立新的廣告空間來源。
editInventorySourceReadWriteAccessors	POST /v1/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors 編輯廣告空間來源的讀取/寫入存取者。
get	GET /v1/inventorySources/{inventorySourceId} 取得廣告空間來源。
list	GET /v1/inventorySources 列出目前使用者可存取的廣告空間來源。
patch	PATCH /v1/inventorySources/{inventorySource.inventorySourceId} 更新現有的廣告空間來源。

REST 資源：v1.media

方法
download	GET /download/{resourceName=**} 下載媒體。
upload	POST /media/{resourceName=**} POST /upload/media/{resourceName=**} 上傳媒體。

REST 資源：v1.partners

方法
bulkEditPartnerAssignedTargetingOptions	POST /v1/partners/{partnerId}:bulkEditPartnerAssignedTargetingOptions 單一夥伴的大量編輯指定目標選項。
get	GET /v1/partners/{partnerId} 取得合作夥伴。
list	GET /v1/partners 列出目前使用者可存取的合作夥伴。

REST 資源：v1.partners.channels

方法
create	POST /v1/partners/{partnerId}/channels 建立新頻道。
get	GET /v1/partners/{partnerId}/channels/{channelId} 為合作夥伴或廣告客戶取得頻道。
list	GET /v1/partners/{partnerId}/channels 列出合作夥伴或廣告客戶的管道。
patch	PATCH /v1/partners/{partnerId}/channels/{channel.channelId} 更新頻道。

REST 資源：v1.partners.channels.sites

方法
bulkEdit	POST /v1/partners/{partnerId}/channels/{channelId}/sites:bulkEdit 大量編輯單一管道下的網站。
create	POST /v1/partners/{partnerId}/channels/{channelId}/sites 在頻道中建立網站。
delete	DELETE /v1/partners/{partnerId}/channels/{channelId}/sites/{urlOrAppId} 從頻道中刪除網站。
list	GET /v1/partners/{partnerId}/channels/{channelId}/sites 列出管道中的網站。
replace	POST /v1/partners/{partnerId}/channels/{channelId}/sites:replace 取代單一管道下的所有網站。

REST 資源：v1.partners.targetingTypes.assignedTargetingOptions

方法
create	POST /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions 為合作夥伴指派指定目標選項。
delete	DELETE /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 從合作夥伴刪除指派的指定目標選項。
get	GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId} 取得指派給合作夥伴的單一指定目標選項。
list	GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions 列出指派給合作夥伴的指定目標選項。

REST 資源：v1.sdfdownloadtasks

方法
create	POST /v1/sdfdownloadtasks 建立 SDF 下載工作。

REST 資源：v1.sdfdownloadtasks.operations

方法
get	GET /v1/{name=sdfdownloadtasks/operations/*} 取得非同步 SDF 下載工作的最新狀態。

REST 資源：v1.targetingTypes.targetingOptions

方法
get	GET /v1/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId} 取得單一指定目標選項。
list	GET /v1/targetingTypes/{targetingType}/targetingOptions 列出指定類型的指定目標選項。
search	POST /v1/targetingTypes/{targetingType}/targetingOptions:search 根據指定搜尋字詞，搜尋特定類型的指定目標選項。

REST 資源：v1.users

方法
bulkEditAssignedUserRoles	POST /v1/users/{userId}:bulkEditAssignedUserRoles 大量編輯使用者的使用者角色。
create	POST /v1/users 建立新使用者。
delete	DELETE /v1/users/{userId} 刪除使用者。
get	GET /v1/users/{userId} 取得使用者。
list	GET /v1/users 列出目前使用者可以存取的使用者。
patch	PATCH /v1/users/{user.userId} 更新現有使用者。