> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/ja/deprecation-schedule-policy/api-deprecation-policy.md).

# API非推奨ポリシー

## 非推奨となる理由

こちらで Epsilon Retail Media では、常に新しいプロダクトや機能を反復的に導入しています。そのため、当社のAPIへの変更は避けられません。ユーザーが変更の計画を立てられるよう、より良いバージョンが利用可能になった場合や、機能のサポート終了が近づいている（または終了した）場合には、非推奨ポリシーに従います。

あるバージョンの非推奨期間は、その非推奨の発表日に始まります。非推奨としてマークされたバージョンは、3か月間の非推奨期間中も引き続き利用可能です。非推奨期間が経過すると、そのバージョンは廃止される予定であり、 Epsilon Retail Media サンセット日以降に利用可能であることを保証できなくなります。

## 当社のAPIに対して適用される非推奨ルール

1. 削除されたAPI要素などの重大な変更（Breaking changes）は、APIのバージョンを繰り上げることによってのみ導入されます。
   * 特定のバージョンでAPI要素が追加されると、そのバージョンから削除したり、その動作を大幅に変更したりすることはできません。
2. APIオブジェクトは、一部のバージョンに存在しないRESTリソース全体を除き、特定のリリース内のAPIバージョン間を情報損失なし（または最小限）で相互変換（ラウンドトリップ）できる必要があります。
   * 例えば、オブジェクトをv1として書き込み、それをv2として読み戻してからv1に変換した場合、生成されるv1リソースは元のものと同一になります。v2での表現はv1と異なる場合がありますが、システムは両方向の変換方法を把握しています。さらに、v2で追加された新しいフィールドはv1との間で相互変換できる必要があるため、v1に同等のフィールドを追加したり、同等のフィールドにマッピングしたり、アノテーションとして表現したりしなければならない場合があります。
   * 重要なプロダクト機能の変更に際しては、APIが後方互換性を持つように設計するようあらゆる努力を払いますが、これが不可能な例外的な状況が発生する場合があります。このような例外については、パートナーと協議いたします。
3. APIバージョンを、より不安定なAPIバージョンのために非推奨にすることはできません。
   * 一般提供（GA）APIバージョンは、より不安定なAlphaおよびBetaバージョンを置き換えることができます。
   * Betaバージョンは、それ以前のBetaまたはAlphaバージョンを置き換えることができますが、GA APIバージョンを置き換えるために使用することはできません。
   * Alphaバージョンは、それ以前のAlphaバージョンを置き換えることができますが、BetaまたはGAバージョンを置き換えるために使用することはできません。
4. 非推奨としてマークされたAPIバージョンは、通知日から最大3か月間サポートされます。そのバージョンのサポートおよび利用が終了する時期をアナウンスします。推奨されるGA APIバージョンが導入された場合、AlphaおよびBetaバージョンはより早く非推奨になることがあります。

* 新しいAPIバージョンは、新バージョンと旧バージョンの両方をサポートするリリースの一部としてのみ導入されます。
* これにより、旧バージョンが利用できなくなり廃止されるまでの期間内に、ユーザーは最新バージョンに移行したり、必要に応じてロールバックしたりする時間を確保できます。

5. 廃止されたバージョンを呼び出すと、予測できない動作や無効なレスポンスが発生する可能性があります。

## 例外

ポリシーですべての状況を網羅できるわけではありません。本書は生きているドキュメントであり、時代とともに常に進化していきます。このポリシーにうまく当てはまらない状況や、このポリシーが重大な障害となる状況がある場合は、 <support@citrusad.com> のチームと課題について話し合い、それらの特定のケースに最適なソリューションを見つけてください。 Epsilon Retail Media は、可能な限りユーザーを混乱させない安定した連携を提供することに尽力しています。例外については、常にすべての関連するリリースノートで発表されます。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/partner/ja/deprecation-schedule-policy/api-deprecation-policy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.