Cities: list

都市のリストを取得します。結果をフィルタできます。実習をご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/cities

パラメータ

パラメータ名 説明
パスパラメータ
profileId long このリクエストに関連付けられるユーザー プロフィール ID。
省略可能なクエリ パラメータ
countryDartIds long これらの国の都市のみを選択します。
dartIds long これらの DART ID を持つ都市のみを選択します。
namePrefix string この接頭辞で始まる名前の都市のみを選択します。
regionDartIds long これらの地域の都市のみを選択します。

認証

このリクエストには、次のスコープによる認証が必要です。

スコープ
https://www.googleapis.com/auth/dfatrafficking

詳しくは、認証と認可のページをご覧ください。

リクエストの本体

このメソッドでは、リクエストの本体を指定しません。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "dfareporting#citiesListResponse",
  "cities": [
    cities Resource
  ]
}
プロパティ名 説明 メモ
kind string リソースの種類を識別します。値: 固定文字列 "dfareporting#citiesListResponse"
cities[] list 都市のコレクション。

実習

以下の API Explorer を使用し、ライブデータに対してこのメソッドを呼び出して、レスポンスを確認してみましょう。