LifeCycle Event Request

Request Types

addapp

An event that occurs when an application is added.

Parameter name

Description

eventtype

Event type (event.addapp)

opensocial_app_id

Application ID

id

User ID of the user who installed the application

mbga_invite_from

User ID of the user who sent the invitation

mbga_is_shellapp

Flag indicating whether the Shell App Framework is used (always 1)

removeapp

An event that occurs when an application is uninstalled.

Parameter name

Description

eventtype

Event type (event.removeapp)

opensocial_app_id

Application ID

id

User ID of the user who uninstalled the application

joingroup

An event that occurs when a user joins an official group of the game.

Parameter name

Description

eventtype

Event type "event.joingroup"

opensocial_app_id

Application ID

id

User ID of the user who joined an official group of the game

leavegroup

An event that occurs when a user leaves an official group of the game.

Parameter name

Description

eventtype

Event type "event.leavegroup"

opensocial_app_id

Application ID

id

User ID of the user who left an official group of the game

postdiary

An event that occurs when a diary entry for the game is written.

Parameter name

Description

eventtype

Event type "event.postdiary"

opensocial_app_id

Application ID

mbga_diary_id

Diary ID

id

User ID of the user who wrote the diary entry for the game

A signature is applied to a request by OAuth. You should always verify the validity of the Authorization request header.

Response

Status: 200
Content-Type: text/plain    

OK

If a response other than 200 is returned, an error is assumed to have occurred and the request is resent during the next notification. It is also an error if no response is returned more than 10 seconds after a request is sent. If the same notification error keeps occurring at regular intervals, it will be dropped.

Restrictions

Currently, lifecycle events have the following limitations.

  • joingroup, leavegroup, and postdiary events are not reported if the user has not installed the application or has already uninstalled it.
    - mbga_is_introduced parameters by function that Inviting a friend outside is the only SmartPhoneWeb and Mobile.

    Reference Links

    OpenSocial v1.0 Lifecycle Events
    OpenSocial v0.9 Lifecycle Events

Revision History

  • 09/30/2012
    • Initial release

PREVIOUS

Life Cycle Evenet

NEXT

XML Schema