REST Resource: platforms.accounts.events
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-04 UTC."],[[["\u003cp\u003eThe Event resource records platform sub-account events, specifically spam signals, with details like event type, information, and timestamp.\u003c/p\u003e\n"],["\u003cp\u003eEventType specifies the nature of the event, such as login or signup via the platform.\u003c/p\u003e\n"],["\u003cp\u003eEventInfo includes private information like the publisher's email and billing address, if available.\u003c/p\u003e\n"],["\u003cp\u003eAddress data comprises detailed location information like street, city, state, zip, and contact details.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides a method to create account events, allowing for the recording of these signals.\u003c/p\u003e\n"]]],["The document details the structure and methods for recording platform sub-account events, including spam signals. An `Event` requires an `EventType` (like `LOG_IN_VIA_PLATFORM` or `SIGN_UP_VIA_PLATFORM`), `EventInfo` (email and optional billing `Address`), and `eventTime`. `Address` includes fields like `address1`, `city`, and `regionCode`. The `create` method enables the creation of a new event. All JSON representations and required fields are specified for each data structure.\n"],null,["# REST Resource: platforms.accounts.events\n\n- [Resource: Event](#Event)\n - [JSON representation](#Event.SCHEMA_REPRESENTATION)\n- [EventType](#EventType)\n- [EventInfo](#EventInfo)\n - [JSON representation](#EventInfo.SCHEMA_REPRESENTATION)\n- [Address](#Address)\n - [JSON representation](#Address.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Event\n---------------\n\nA platform sub-account event to record spam signals.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"eventType\": enum (/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events#EventType), \"eventInfo\": { object (/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events#EventInfo) }, \"eventTime\": string } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `eventType` | `enum (`[EventType](/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events#EventType)`)` Required. Event type. |\n| `eventInfo` | `object (`[EventInfo](/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events#EventInfo)`)` Required. Information associated with the event. |\n| `eventTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Required. Event timestamp. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\nEventType\n---------\n\nPlatform recorder event type.\n\n| Enums ||\n|--------------------------|----------------------------------------------------|\n| `EVENT_TYPE_UNSPECIFIED` | Do not use. You must set an event type explicitly. |\n| `LOG_IN_VIA_PLATFORM` | Log in via platform. |\n| `SIGN_UP_VIA_PLATFORM` | Sign up via platform. |\n\nEventInfo\n---------\n\nPrivate information for partner recorded events (PII).\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"email\": string, \"billingAddress\": { object (/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events#Address) } } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `email` | `string` Required. The email address that is associated with the publisher when performing the event. |\n| `billingAddress` | `object (`[Address](/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events#Address)`)` The billing address of the publisher associated with this event, if available. |\n\nAddress\n-------\n\nAddress data.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"address1\": string, \"address2\": string, \"city\": string, \"state\": string, \"zip\": string, \"company\": string, \"contact\": string, \"phone\": string, \"fax\": string, \"regionCode\": string } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------|\n| `address1` | `string` First line of address. Max length 64 bytes or 30 characters. |\n| `address2` | `string` Second line of address. Max length 64 bytes or 30 characters. |\n| `city` | `string` City. Max length 60 bytes or 30 characters. |\n| `state` | `string` State. Max length 60 bytes or 30 characters. |\n| `zip` | `string` Zip/post code. Max length 10 bytes or 10 characters. |\n| `company` | `string` Name of the company. Max length 255 bytes or 34 characters. |\n| `contact` | `string` Contact name of the company. Max length 128 bytes or 34 characters. |\n| `phone` | `string` Phone number with international code (i.e. +441234567890). |\n| `fax` | `string` Fax number with international code (i.e. +441234567890). |\n| `regionCode` | `string` Country/Region code. The region is specified as a CLDR region code (e.g. \"US\", \"FR\"). |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|---------------------------|\n| ### [create](/adsense/platforms/reference/rest/v1alpha/platforms.accounts.events/create) | Creates an account event. |"]]
