LLM コーディングエージェントのパブリッシャー公開 API 移行リファレンス

オーディエンス：このファイルは、LLM コーディングエージェント (クロードコードまたは Unityの古い機能である「Monetize」からクライアントのインテグレーションを移行するタスク Manage API」(

/monetize/v1/...

)を新しい Unity Ads パブリッシャー Public API に追加 (

/ads/publisher/public/v1/...

).自己完結型エンティティブロックに分割されます。各ブロック _何が変更_され、_何をする_かを示します。概念モデル変更を読む グローバル変更セクションは、まずすべてのブロックに適用されます。

このファイルの使用方法(エージェントの手順)

1. この散文ではなく、2 つの契約を真実のソースとして扱います。古い機能 =

   ads-selfserve/src/servers/http-internal/openapi/public-v1.yaml

   .新規 =

   ads-unified-platform/openapi/publisher/platform-public-v1-routes.yaml

   .
2. 指定した順序でエンティティブロックを 1 つずつ移行します (「アプリケーション」→「プレースメント」→「 組織レベルリスト)。ブロックは、依存するブロックがコンパイルまたはパスするまで開始しません。
3. レガシー機能が 🚫 No equivalent (同等の機能 なし) の下にリストされている場合、 エンドポイント。停止し、オープンな質問としてユーザーに提示します。最も重要な例 は eCPM ターゲットで、新しい API にはありません。
4. 各ブロックの後に、フィールドテーブルごとにフィールド名を再マップする。フィールドは持ち越されないと仮定する テーブルに "unchanged" と表示されていない限り変更されません。

概念モデルの変更 (最初にお読みください)

古い機能モデル (ネストされたプロジェクト中心)

組織└──── プロジェクト（両ストアにまたがる、coppa + adsProvider あり）    └── ストア （Apple | Google） （URL パス内）        └── 広告単位 (adFormat、スキップ/ミュート/バナー設定はこちら)            └── Placement                └── eCPM ターゲット (地域ベースの下限価格)

新しいモデル(フラットなアプリケーション中心)

組織└── アプリケーション (プラットフォーム + ストアが 1 つずつ、プライバシー + テストモードあり)    └── 配置 (adFormat + adFormatConfigurations をここに配置。ターゲットなし)組織└── テストデバイス (新規、組織スコープ付き)

すべてのトランスフォーメーションを推進する4つのシフト

apple

google

projectId

projectName

adFormatConfigurations

adFormat

POST

PUT

DELETE

グローバル変更（すべてのエンドポイントに適用）

https://services.api.unity.com

https://services.api.unity.com/ads/publisher

https://staging.services.api.unity.com/ads/publisher

/monetize/v1

/public/v1

…/monetize/v1/organizations/{orgId}/projects

…/ads/publisher/public/v1/organizations/{organizationId}/applications

unity

ads

organizationId

organizationId

projectId

applicationId

dryrun

showarchived

isArchived

archive: true/false

DELETE

PATCH …/restore

レート制限の変更(クライアント側のバックオフ前提条件の更新)

GET

POST

PATCH

PUT

DELETE

マスター エンドポイント マップ

getProjects

GET /monetize/v1/organizations/{orgId}/projects

publicOrganizationApplications

GET /public/v1/organizations/{orgId}/applications

postProjects

POST /monetize/v1/organizations/{orgId}/projects

publicCreateApplication

POST /public/v1/organizations/{orgId}/applications

getProjectDetails

GET /monetize/v1/projects/{projectId}

publicGetApplicationById

GET /public/v1/organizations/{orgId}/applications/{applicationId}

updateProjectDetails

PATCH /monetize/v1/projects/{projectId}

publicUpdateApplication

PATCH /public/v1/organizations/{orgId}/applications/{applicationId}

getAdUnitsByProject

getAdUnitsByProjectStore

createAdUnits

updateAdUnits

getAdUnits

patchAdUnits

…/projects/{projectId}/[stores/{storeName}/]adunits[/{adUnitId}]

createPlacements

POST …/adunits/{adUnitId}/placements

publicCreatePlacement

POST /public/v1/organizations/{orgId}/applications/{applicationId}/placements

GetPlacements

GET …/adunits/{adUnitId}/placements

publicApplicationPlacements

GET …/applications/{applicationId}/placements

getPlacement

GET …/placements/{placementId}

publicGetPlacementDetails

GET …/applications/{applicationId}/placements/{placementId}

updatePlacements

updatePlacement

PATCH …/placements[/{placementId}]

publicUpdatePlacement

PUT …/applications/{applicationId}/placements/{placementId}

archive:true

PATCH …/placements/{placementId}

publicArchivePlacement

DELETE …/applications/{applicationId}/placements/{placementId}

archive:false

PATCH …/placements/{placementId}

publicUnArchivePlacement

PATCH …/applications/{applicationId}/placements/{placementId}/restore

GetPlacements

GET /monetize/v1/organizations/{orgId}/placements

publicOrganizationPlacements

GET /public/v1/organizations/{orgId}/placements

getTargets

createTargets

getTargetDetail

patchTarget

deleteTarget

…/placements/{placementId}/targets[/{targetId}]

publicGetApplicationTestMode

publicUpdateApplicationTestMode

GET

PATCH …/applications/{applicationId}/test-mode

…/organizations/{orgId}/test-devices[/{testDeviceId}]

ブロック A - プロジェクト → アプリケーション

変更内容

• リスト/作成/読み取り/更新したリソースは、プロジェクトではなくアプリケーションになります。
• 読み取り/更新が org (

  /organizations/{orgId}/applications/{applicationId}

  ) の下にネストされるようになりました。 スタンドアロン

  /projects/{projectId}

  ではなく、

  applicationId

  (Unity App ID) によってキー付けされます。
• 古い機能プロジェクトでは両方のストアが使用され、新しいアプリケーションはシングルプラットフォームです。分割 （Transform rules を参照）。

• adsProvider

  はなくなりました。

  coppa

  は enum 文字列からブーリアンに変更され、 新しい

  mixedAudience

  ブーリアンを持つ

  privacy

  オブジェクト。

エンドポイントマッピング

GET …/organizations/{orgId}/projects

GET …/organizations/{orgId}/applications

POST …/organizations/{orgId}/projects

POST …/organizations/{orgId}/applications

GET …/projects/{projectId}

GET …/organizations/{orgId}/applications/{applicationId}

PATCH …/projects/{projectId}

PATCH …/organizations/{orgId}/applications/{applicationId}

フィールドマッピング — 作成 (createProject → CreateApplicationPublicDto)

name

name

adsProvider

coppa

"compliant"

"non_compliant"

privacy.coppa

"compliant"

true

"non_compliant"

false

privacy.mixedAudience

privacy

false

stores.apple

stores.google

{storeId, storeUrl}

store

storeId

platform

platform

iOS

Android

iconUrl

projectId

projectName

フィールドマッピング — 更新（updateProject → UpdateApplicationPublicDto）

adsProvider

coppa

privacy.coppa

privacy.*

stores

store

storeId

name

kidsSettings

true

フィールドマッピング — 反応（project/projectDetail → ApplicationPublicResponseDto）

id

id

projectId

id

projectId

name

name

coppa

coppa

mixedAudience

adsProvider

stores

store

storeId

platform

archivedAt

maxCaps

iconUrl

testMode

kidsSettings

Transform 規則: 1 つの古い機能プロジェクト → N つのアプリケーション

stores.apple

stores.google

POST /applications

platform: iOS

store: AppleAppStore

storeId: <apple.storeId>

platform: Android

store: GooglePlay

storeId: <google.storeId>

projectName: <project.name>

projectId

projectId

例

POST /monetize/v1/organizations/3573617062594/projects{  "name": マイゲーム  "adsProvider": "unity",  "coppa": "non_compliant",  "stores": {    "apple":  { "storeId":"1479198816", "storeUrl": "https://apps.apple.com/..." },    "google": { "storeId": "com.unity.trashdash", "storeUrl": "https://play.google.com/..." }  }}

POST /ads/publisher/public/v1/organizations/3573617062594/applications{  "name": マイゲーム  "platform": "iOS",  "store":"AppleAppStore",  "storeId":"1479198816",  "privacy": { "coppa": false, "mixedAudience": false },  "projectName":マイゲーム}// → response.projectId = "5a8591dd-..."; reuse it for the second app:POST /ads/publisher/public/v1/organizations/3573617062594/applications{  "name": マイゲーム  "platform":"Android",  "store":"GooglePlay",  "storeId": "com.unity.trashdash",  "privacy": { "coppa": false, "mixedAudience": false },  "projectId":"5a8591dd-..."}

Block B — Ad-Units (広告ユニット) → 削除 (アプリケーション + 配置に展開)

🚫 同等のリソースなし

…/projects/{projectId}/[stores/{storeName}/]adunits…

getAdUnitsByProject

getAdUnitsByProjectStore

createAdUnits

updateAdUnits

getAdUnits

patchAdUnits

広告単位データの送信先

adFormat

rewarded

interstitial

banner

adFormat

allowSkipInSeconds

muteVideo

adFormatConfigurations.adminSettings.{allowSkipInSeconds, muteVideo}

bannerRefreshRate

adFormatConfigurations.bannerRefreshRate

adTypes

display

playable

video

placements

adFormat

adFormatConfigurations

ブロック C — プレースメント（アプリケーションごと）

変更内容

• パスが

  …/applications/{applicationId}/placements[/{placementId}]

  になりました。ストア/広告単位はありません。 セグメント。
• 個々の操作がバッチマップ/配列に置き換わります。
• 各配置で**

  adFormat

  が必要**です（広告単位のプロパティでした）。
• 新しい**

  adFormatConfigurations

  **オブジェクトはプレイヤー/管理者設定を保持します。形状は

  adFormat

  （リワード型/インタースティシャル/バナー）。
• 配置ボディから eCPM

  targets

  が削除されます（ブロック E を参照）。
• 識別子：古い機能

  placementId

  はナメクジ（

  ^[\da-zA-Z_-]+$

  ）で、新しい配置

  id

  は UUID。人間が判読できるスラッグは、**

  key

  **として個別に返されます（

  name

  から生成）。
• アーカイブ/復元は専用のオペレーションであり、ボディ フラグではありません。
• 配置ごとの更新は

  PUT

  （完全置換）であり、

  PATCH

  ではありません。

エンドポイントマッピング

POST …/adunits/{adUnitId}/placements

POST …/applications/{applicationId}/placements

GET …/adunits/{adUnitId}/placements

GET …/applications/{applicationId}/placements

isArchived

adFormat[]

GET …/placements/{placementId}

GET …/applications/{applicationId}/placements/{placementId}

PATCH …/placements/{placementId}

PUT …/applications/{applicationId}/placements/{placementId}

PATCH …

{"archive": true}

DELETE …/placements/{placementId}

PATCH …

{"archive": false}

PATCH …/placements/{placementId}/restore

フィールドマッピング — リクエスト（addPlacements[]/patchPlacementObject → PlacementPublicRequestDto）

name

name

id

id

key

adFormat

rewarded

interstitial

banner

adFormat

addTargets

targets

placementType

archive

DELETE

restore

adFormatConfigurations

adFormatConfigurations形状 (adFormat)

• rewarded (

  RewardedConfigurations

  ):

  name

  (報酬名、必須)、

  value

  (報酬値、 必須)、

  adminSettings

  (

  AdminConfigurations

  )。
• インタースティシャル (

  InterstitialConfigurations

  ):

  adminSettings

  。
• バナー（

  BannerConfigurations

  ）：

  adminSettings

  、

  bannerRefreshRate

  （必須）。

• AdminConfigurations

  :

  allowSkip

  ,

  allowSkipInSeconds

  ,

  videoPlayableSkipInSeconds

  ,

  closeTimerDuration

  ,

  tapsToClose

  ,

  muteVideo

  ,

  disableVideoControlsFade

  ,

  useCloseIconInsteadOfSkipIcon

  .

フィールドマッピング — 反応 （placement → PlacementPublicResponseDto）

id

key

key

id

name

name

archivedAt

archivedAt

null

placementType

targets

adFormat

status

active

paused

adFormatConfigurations

applicationId

createdAt

updatedAt

⚠️ **IDを再マップすることは最もリスクの高いステップです。**クライアントが古い機能の配置を維持していた場所 slug を識別子として使用する場合、パス操作の新しい UUID

id

を格納する必要があります。 は

key

として存続します。

legacy placement slug → new {id, key}

検索のビルドと永続化は、 移行。

例

POST /monetize/v1/projects/{projectId}/stores/apple/adunits/{adUnitId}/placements[ { "name":"Rewarded Placement", "id": "rewarded_01",    "addTargets": [ { "value":18.5, "type": "global" } ] } ]

POST /ads/publisher/public/v1/organizations/{orgId}/applications/{applicationId}/placements{  "name": "リワード配置",  "adFormat": "rewarded",  "adFormatConfigurations": {    "name": "coins",    "value":100,    "adminSettings": { "allowSkip": true, "allowSkipInSeconds":5, "muteVideo": false }  }}

ブロック D — 組織プレースリスト

変更内容

targets

adFormat

platform

storeId

id

placementId

エンドポイントマッピング

GET /monetize/v1/organizations/{orgId}/placements

GET /public/v1/organizations/{orgId}/placements

フィールドマッピング (placementWithGameId → OrganizationPlacementPublicResponseDto)

id

placementId

Banner_Android

name

name

placementType

placementType

bidding

gameId

gameId

targets

adFormat

rewarded

interstitial

banner

native

platform

ios

android

""

""

storeId

ブロックE - eCPMターゲットを削除

🚫 新しいパブリック API には同等のものはありません

getTargets

createTargets

getTargetDetail

patchTarget

deleteTarget

targets

addTargets

1. これらを新しいエンドポイントにマップしないでください。

   …/targets

   パスを作成しません。
2. すべての配置作成/更新ペイロードから

   targets

   /

   addTargets

   を削除します。
3. クライアントのインテグレーションがこのAPIを介してeCPMの下限価格を管理する場合は、これを停止してレポートする 人間がブロックするギャップ — eCPMターゲット管理は新しいパブリッシャーではカバーされない パブリックAPI。帯域外で処理する必要がある(例えば、異なるUnityサーフェスや製品を使用) decision)。明示的にフラグを立てます。価格ロジックを提示せずに黙ってドロップしないでください。

ブロック F — アプリケーションテストモード (NEW)

• GET …/applications/{applicationId}/test-mode

  →

  { id, testMode }

• PATCH …/applications/{applicationId}/test-mode

  と

  { "testMode": "forceAll" | "forceOff" }

testMode

ブロック G — テストデバイス (NEW)

• POST …/organizations/{orgId}/test-devices

  —

  CreateTestDevicePublicDto

  { name*, advertisingId*, platform? }

• GET …/organizations/{orgId}/test-devices

  — リスト（任意の

  platform

  フィルター）

• GET …/organizations/{orgId}/test-devices/{testDeviceId}

  — 購入

• PATCH …/organizations/{orgId}/test-devices/{testDeviceId}

  —

  UpdateTestDevicePublicDto

• DELETE …/organizations/{orgId}/test-devices/{testDeviceId}

  — 204

testDeviceId

platform

Android

iOS

OSX

Windows

Linux

WebGL

Windows_Store

PS4

PS5

XboxOne

tvOS

Switch

VisionOS

推奨される移行アルゴリズム (エージェントの決定的な順序)

1. 構成: ベースホストを

   …/ads/publisher

   にスワップし、パスプレフィックスを「

   /monetize/v1

   」→「

   /public/v1

   」にします。 Basic 認証を維持します。すべての

   dryrun

   パラメーターを削除します。
2. アプリケーション(ブロックA):古い機能プロジェクトごとに、ストアごとに1つのアプリケーションを作成。Transform

   coppa

   enum→boolean、drop

   adsProvider

   、set

   platform

   /

   store

   /

   storeId

   。グループ化

   projectName

   /

   projectId

   .

   legacy projectId+store → new {applicationId, projectId}

   マップを持続します。
3. **Placements（Block C）：古い機能配置ごとに、マップから所有アプリケーションを解決し、

   adFormat

   （古い機能の広告単位） +

   adFormatConfigurations

   を使用して個別に作成 (広告単位/管理者設定から)。

   targets

   /

   addTargets

   をドロップします。**持続

   legacy placement slug → new {id, key}

   .
4. **再ポイント識別子：**格納された古い機能配置ナメクジをパスの新しい UUID

   id

   に置き換えます。 ops (ディスプレイの

   key

   を保持)。格納されている

   projectId

   ベースのアプリケーション参照を

   applicationId

   に置き換えます。
5. アーカイブセマンティクス:

   archive:true/false

   パッチコールを

   DELETE

   /

   PATCH …/restore

   に置き換えます。
6. リスト/読み取り形状： フィールドテーブルごとの反応解析の更新（esp. org リスト — ブロック D）。
7. **eCPMターゲット(**ブロックE): ターゲットコードを削除し、ユーザーにレポートします。
8. 任意新機能: テストモード (F) とテストデバイス (G) は、必要な場合のみ接続します。
9. レート制限: 上限は 1 秒未満と 60 時間未満で作成され、20 秒未満で読み取ります。

検証チェックリスト (移行後に実行)

• リクエスト パスに

  /monetize/v1

  、

  /projects/{

  、

  /adunits

  、

  /stores/

  、または

  /targets

  は含まれません。

• adsProvider

  、

  addTargets

  、

  targets

  、または

  archive

  を含むリクエスト ボディはありません。

• coppa

  は、すべての場所でブーリアンです （決して

  "compliant"

  /

  "non_compliant"

  ではありません）。
• 配置作成/更新のたびに、有効な

  adFormat

  と

  adFormatConfigurations

  が送信されます。 その形式と一致します。
• 配置パスパラメーターは、古い機能のナメクジ （

  key

  ） ではなく、新しい UUID

  id

  を使用します。
• 2つのストアを持つ古い機能プロジェクトでは、1つの

  projectId

  を共有する2つのアプリケーションが生成されていました。
• eCPM ターゲット管理は、(クライアントがターゲット管理を使用している場合) サポートされていないギャップとしてユーザーに認識されました。

クイック リファレンス:🚫削除済み/同等なし(移行または製造しない)

• すべての広告単位エンドポイントと広告単位リソース。
• すべての eCPM ターゲットエンドポイントと

  targets

  /

  addTargets

  フィールド。
• プロジェクトの

  adsProvider

  と

  maxCaps

  。

• dryrun

  および

  showarchived

  クエリパラメーター。
• クライアントによって選択された配置 ID（サーバが UUID を割り当てます。スラッグは

  key

  として保持します）。