Bidders - ユーザー サービス

ここで "user" とは、Xandr の API を使用するユーザーまたはグループを指します。 ユーザー サービスを使用すると、Xandr の API にアクセスできるユーザーを管理できます。 ユーザーは、 入札者 または メンバーのユーザーの種類によって分類されます。

• Bidder ユーザーは、他の入札者ユーザーによって作成できます。
• bidder-user は、メンバー ユーザーを作成および更新したり、独自のユーザー情報を更新したりできます。
• メンバー ユーザーは、独自のユーザー情報を更新できます。
• 特定の入札者に関連付けられている新しいユーザー名はそれぞれ一意である必要があります。

REST API

既存のユーザーを削除するには:
DELETE https://api.adnxs.com/user/USER_ID

JSON 構造体

例

認証トークン

API Services を使用する場合、認証は常に最初の手順です。 認証トークンは、後で使用するために Cookie ファイルに書き込むことができます。 詳細な手順については、 認証サービス に関するページを参照してください。

ユーザー プロファイル テキスト ファイルを作成する

"TestUser" へのアクセス権を API に付与するには、ユーザーのユーザー名とパスワードと、このユーザーが属するメンバーまたは入札者の ID を含む JSON 形式のテキスト ファイルを作成します。 次に、"cat" コマンドを使用してユーザー JSON ファイルの例を出力しました。

$ cat user
{
   "user":{
      "username":"TestUser",
      "password":"2323test",
      "entity_id":7,
          "email": "user1@examplecompany.com",
          "user_type": "bidder"
   }
}

パスワードを作成するためのガイドライン

パスワードを作成するときは、次の複雑なパスワードを作成してください。

• 10 文字以上
• 64 文字以下
• 少なくとも 1 つの大文字 (A から Z)
• 少なくとも 1 つの小文字 (a から z)
• 少なくとも 1 桁 (0 から 9)
• 少なくとも 1 つの特殊文字 (#、$、? %、& など)

Imp Bus キャッシュに新しいユーザーを追加する

次に、ユーザー ファイルを入力します。 私たちは、自分自身を認証するためにクッキーを使用しています。

$ curl -b cookies -c cookies -X POST --data-binary @user https://api.adnxs.com/user
{
   "response":{
      "status":"OK",
      "id":59
   }
}

Imp Bus キャッシュからユーザー情報を取得する

上記のコマンドの出力から、先ほど追加したユーザーに Imp Bus によって ID #59 が割り当てられていることがわかっています。 この ID を使用して、この特定のユーザーに関する情報を表示できます。 作成したすべてのユーザーを表示するには、ユーザー ID をオフにします。

$ curl -b cookies -c cookies https://api.adnxs.com/user/59
{
  "response": {
    "status": "OK",
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "user": {
      "id": 59,
      "active": true,
      "first_name": null,
      "last_name": null,
      "phone": null,
      "username": "TestUser",
      "email": "user1@examplecompany.com",
      "user_type": "bidder",
      "read_only": false,
      "api_login": false,
      "entity_id": 7,
      "publisher_id": null,
      "advertiser_id": null,
      "custom_data": null,
      "send_safety_budget_notifications": false,
      "entity_name": "Platform Services Test Bidder",
      "timezone": null,
      "entity_reporting_decimal_type": null,
      "reporting_decimal_type": null,
      "decimal_mark": "period",
      "thousand_separator": "comma",
      "last_modified": "2017-02-16 19:06:47",
      "is_developer": false,
      "role_id": null,
      "languages": null,
      "advertiser_access": null,
      "publisher_access": null
    },
    "dbg": {
                ...
    }
  }
}

API アクセスを要求する

api_login フィールドの上にある返されたコードに注目してください。 このフィールドは、Xandr 管理者のみが変更できます。 ユーザーに API へのアクセス権を付与する最後の手順は、カスタマー サポートに問い合わせ、ユーザーの api_login フラグを true に設定するように要求 することです。 要求にはユーザー名または ID を必ず含めます。

関連トピック

API Services