Gmail API . users

close()

Close httplib2 connections.

getProfile(userId, x__xgafv=None)

Gets the current user's Gmail profile.

Args:
  userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Profile for a Gmail user.
  "emailAddress": "A String", # The user's email address.
  "historyId": "A String", # The ID of the mailbox's current history record.
  "messagesTotal": 42, # The total number of messages in the mailbox.
  "threadsTotal": 42, # The total number of threads in the mailbox.
}

stop(userId, x__xgafv=None)

Stop receiving push notifications for the given user mailbox.

Args:
  userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

watch(userId, body=None, x__xgafv=None)

Set up or update a push notification watch on the given user mailbox.

Args:
  userId: string, The user's email address. The special value `me` can be used to indicate the authenticated user. (required)
  body: object, The request body.
    The object takes the form of:

{ # Set up or update a new push notification watch on this user's mailbox.
  "labelFilterAction": "A String", # Filtering behavior of `labelIds list` specified. This field is deprecated because it caused incorrect behavior in some cases; use `label_filter_behavior` instead.
  "labelFilterBehavior": "A String", # Filtering behavior of `labelIds list` specified. This field replaces `label_filter_action`; if set, `label_filter_action` is ignored.
  "labelIds": [ # List of label_ids to restrict notifications about. By default, if unspecified, all changes are pushed out. If specified then dictates which labels are required for a push notification to be generated.
    "A String",
  ],
  "topicName": "A String", # A fully qualified Google Cloud Pub/Sub API topic name to publish the events to. This topic name **must** already exist in Cloud Pub/Sub and you **must** have already granted gmail "publish" permission on it. For example, "projects/my-project-identifier/topics/my-topic-name" (using the Cloud Pub/Sub "v1" topic naming format). Note that the "my-project-identifier" portion must exactly match your Google developer project id (the one executing this watch request).
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Push notification watch response.
  "expiration": "A String", # When Gmail will stop sending notifications for mailbox updates (epoch millis). Call `watch` again before this time to renew the watch.
  "historyId": "A String", # The ID of the mailbox's current history record.
}