はじめに
マーケティングAPIには、 インタレストマッチ広告管理システムを操作するための様々なコンポーネントが用意されています。これらのコンポーネントを用いてSOAPリクエストを作成し、そのレスポンス受け取ります。
注意: マーケティングAPIにて設定する各項目は、大文字と小文字を区別します。
サービス
マーケティングAPIは複数のサービスをサポートしています。「 スタートアップガイド」では、各サービスを論理的グループに分類しています。
コマンド
各サービスには1つ以上のコマンドが含まれます。各コマンドは、インタレストマッチAPIへの1つのリクエストおよびインタレストマッチAPIからの1つのレスポンスを表します。リクエストには、別途パラメータを設定する必要のあるコマンドがあります。パラメータは、データオブジェクトまたは単純なデータタイプ、またはその両方から構成されます。パラメータが必要な場合は、すべてについて入力値を設定し(場合によってはNull値を指定できます)、パラメータが不要な場合は入力値は設定不要です。
レスポンスは、インタレストマッチAPIからデータが戻される場合とレスポンスとして空のレスポンスが戻される場合があります。
データオブジェクト
データオブジェクトは、複雑なデータタイプまたは単純なデータタイプ、またはその両方から構成される、複雑なデータタイプです。データオブジェクトによってコマンドが形成されます。
制限事項
マーケティングAPIを通して、追加または更新リクエストを行う場合、次のように表記します。
・ オペレーション: 追加(Add)、更新(Full-Up)
・ 値: 必須(Req)、読み取り専用(RO)、オプション(Opt)
「追加(Add)」コマンド
・ 必須項目を設定する必要があります。
・ 読み取り専用項目は変更できません。設定された場合は無視されます。
・ オプション項目は状況によって設定します。
「更新(Full-Up)」
・ 必須項目を設定する必要があります。
・ 読み取り専用項目は変更できません。設定された場合は無視されます。
・ オプション項目は状況によって設定します。Null値または設定しなかった場合は、現行の値が消去されます。