NOTICE: Google Maps Platform gaming services is deprecated as of October 18, 2021. Current users will have continued access until December 31, 2022. During this time, we will continue to provide support and fixes to major bugs and outages. See the Gaming Services Transition Guide for resources to help you plan the next steps for your projects.

Method: logImpressions

Logs new events when playable locations are displayed, and when they are interacted with.

Impressions are not partially saved; either all impressions are saved and this request succeeds, or no impressions are saved, and this request fails.

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
  "impressions": [
      object (Impression)
  "requestId": string,
  "clientInfo": {
    object (ClientInfo)

object (Impression)

Required. Impression event details. The maximum number of impression reports that you can log at once is 50.



Required. A string that uniquely identifies the log impressions request. This allows you to detect duplicate requests. We recommend that you use UUIDs for this value. The value must not exceed 50 characters.

You should reuse the requestId only when retrying a request in case of failure. In this case, the request must be identical to the one that failed.


object (ClientInfo)

Required. Information about the client device. For example, device model and operating system.

Response body

If successful, the response body will be empty.


Encapsulates impression event details.

JSON representation
  "locationName": string,
  "impressionType": enum (ImpressionType),
  "gameObjectType": integer


Required. The name of the playable location.


enum (ImpressionType)

Required. The type of impression event.



An arbitrary, developer-defined type identifier for each type of game object used in your game.

Since players interact with differ types of game objects in different ways, this field allows you to segregate impression data by type for analysis.

You should assign a unique gameObjectType ID to represent a distinct type of game object in your game.

For example, 1=monster location, 2=powerup location.


The type of impression event.

IMPRESSION_TYPE_UNSPECIFIED Unspecified type. Do not use.
PRESENTED The playable location was presented to a player.
INTERACTED A player interacted with the playable location.