Method: logPlayerReports

プレーヤーから送信された、不適切なプレイアブル ロケーションの報告をログに記録します。

報告の一部のみが保存されることはありません。リクエストが成功するとすべての報告が保存され、リクエストが失敗すると報告は一切保存されません。

HTTP リクエスト

POST https://playablelocations.googleapis.com/v3:logPlayerReports

この URL は gRPC Transcoding 構文を使用します。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "playerReports": [
    {
      object (PlayerReport)
    }
  ],
  "requestId": string,
  "clientInfo": {
    object (ClientInfo)
  }
}
フィールド
playerReports[]

object (PlayerReport)

必須。プレーヤーの報告。ログに一度に記録できるプレーヤーの報告の最大数は 50 です。

requestId

string

必須。プレーヤーによる報告の記録リクエストを一意に識別する文字列。これを使用して重複するリクエストを検出できます。この値には UUID を使用することをおすすめします。値は半角 50 文字以内で指定してください。

requestId を再利用できるのは、失敗したリクエストを再試行する場合に限られます。その場合は、失敗したものと同じリクエストを再試行する必要があります。

clientInfo

object (ClientInfo)

必須。クライアント デバイスに関する情報(デバイスのモデルやオペレーティング システムなど)。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

PlayerReport

プレーヤーから送信された、ゲームでの使用に不適切と見なされるプレイアブル ロケーションの報告。

JSON 表現
{
  "locationName": string,
  "reasons": [
    enum (BadLocationReason)
  ],
  "reasonDetails": string,
  "languageCode": string
}
フィールド
locationName

string

必須。プレイアブル ロケーションの名前。

reasons[]

enum (BadLocationReason)

必須。このプレイアブル ロケーションが不適切と見なされる 1 つ以上の理由。

reasonDetails

string

必須。プレイアブル ロケーションが不適切と見なされる理由に関する自由形式の詳細な説明。

languageCode

string

reasonDetails で提供される自由形式の説明の言語を示す、BCP-47 形式の言語コード(「en」、「en-US」、「ja-Latn」など)。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier をご覧ください。

BadLocationReason

プレイアブル ロケーションが不適切と見なされる理由。

列挙型
BAD_LOCATION_REASON_UNSPECIFIED 理由の指定なし。使用しないでください。
OTHER 理由は、この列挙型の理由に該当しません。
NOT_PEDESTRIAN_ACCESSIBLE プレイアブル ロケーションに徒歩でアクセスできません(高速道路の真ん中にある場合など)。
NOT_OPEN_TO_PUBLIC プレイアブル ロケーションは一般公開されていません(私有のオフィスビルなど)。
PERMANENTLY_CLOSED プレイアブル ロケーションは閉業しています(店舗が廃業した場合など)。
TEMPORARILY_INACCESSIBLE プレイアブル ロケーションは一時的に利用できません(店舗が改装のために休業している場合など)。