Gmail Postmaster Tools API . domains

close()

Close httplib2 connections.

get(name, x__xgafv=None)

Retrieves detailed information about a domain registered by you. Returns NOT_FOUND if the domain is not registered by you. Domain represents the metadata of a domain that has been registered within the system and linked to a user.

Args:
  name: string, Required. The resource name of the domain. Format: `domains/{domain_name}`, where domain_name is the fully qualified domain name (i.e., mymail.mydomain.com). (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Information about a domain registered by the user.
  "createTime": "A String", # Output only. Immutable. The timestamp at which the domain was added to the user's account.
  "lastVerifyTime": "A String", # The timestamp at which the domain was last verified by the user.
  "name": "A String", # Identifier. The resource name of the domain. Format: `domains/{domain_name}`, where domain_name is the fully qualified domain name (i.e., mymail.mydomain.com).
  "permission": "A String", # Output only. User's permission of this domain.
  "verificationState": "A String", # Output only. Information about a user's verification history and properties for the domain.
}

getComplianceStatus(name, x__xgafv=None)

Retrieves the compliance status for a given domain. Returns PERMISSION_DENIED if you don't have permission to access compliance status for the domain.

Args:
  name: string, Required. The resource name of the domain's compliance status to retrieve. Format: `domains/{domain_id}/complianceStatus`. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Compliance status for a domain.
  "complianceData": { # Compliance data for a given domain. # Compliance data for the registrable domain part of the domain in `name`. For example, if `name` is `domains/example.com/complianceStatus`, this field contains compliance data for `example.com`.
    "domainId": "A String", # Domain that this data is for.
    "honorUnsubscribeVerdict": { # Compliance verdict for whether a sender meets the unsubscribe honoring compliance requirement. # Unsubscribe honoring compliance verdict.
      "reason": "A String", # The specific reason for the compliance verdict. Must be empty if the status is compliant.
      "status": { # The status of a sender compliance requirement. # The compliance status.
        "status": "A String", # Output only. The compliance status.
      },
    },
    "oneClickUnsubscribeVerdict": { # Compliance verdict for whether a sender meets the one-click unsubscribe compliance requirement. # One-click unsubscribe compliance verdict.
      "reason": "A String", # The specific reason for the compliance verdict. Must be empty if the status is compliant.
      "status": { # The status of a sender compliance requirement. # The compliance status.
        "status": "A String", # Output only. The compliance status.
      },
    },
    "rowData": [ # Data for each of the rows of the table. Each message contains all the data that backs a single row.
      { # Data for a single row of the compliance status table.
        "requirement": "A String", # The compliance requirement.
        "status": { # The status of a sender compliance requirement. # The compliance status for the requirement.
          "status": "A String", # Output only. The compliance status.
        },
      },
    ],
  },
  "name": "A String", # Identifier. The resource name of the domain's compliance status. Format: `domains/{domain_id}/complianceStatus`.
  "subdomainComplianceData": { # Compliance data for a given domain. # Compliance data calculated specifically for the subdomain in `name`. This field is only populated if the domain in `name` is a subdomain that differs from its registrable domain (e.g., `sub.example.com`), and if compliance data is available for that specific subdomain.
    "domainId": "A String", # Domain that this data is for.
    "honorUnsubscribeVerdict": { # Compliance verdict for whether a sender meets the unsubscribe honoring compliance requirement. # Unsubscribe honoring compliance verdict.
      "reason": "A String", # The specific reason for the compliance verdict. Must be empty if the status is compliant.
      "status": { # The status of a sender compliance requirement. # The compliance status.
        "status": "A String", # Output only. The compliance status.
      },
    },
    "oneClickUnsubscribeVerdict": { # Compliance verdict for whether a sender meets the one-click unsubscribe compliance requirement. # One-click unsubscribe compliance verdict.
      "reason": "A String", # The specific reason for the compliance verdict. Must be empty if the status is compliant.
      "status": { # The status of a sender compliance requirement. # The compliance status.
        "status": "A String", # Output only. The compliance status.
      },
    },
    "rowData": [ # Data for each of the rows of the table. Each message contains all the data that backs a single row.
      { # Data for a single row of the compliance status table.
        "requirement": "A String", # The compliance requirement.
        "status": { # The status of a sender compliance requirement. # The compliance status for the requirement.
          "status": "A String", # Output only. The compliance status.
        },
      },
    ],
  },
}

list(pageSize=None, pageToken=None, x__xgafv=None)

Retrieves a list of all domains registered by you, along with their corresponding metadata. The order of domains in the response is unspecified and non-deterministic. Newly registered domains will not necessarily be added to the end of this list.

Args:
  pageSize: integer, Optional. Requested page size. Server may return fewer domains than requested. If unspecified, the default value for this field is 10. The maximum value for this field is 200.
  pageToken: string, Optional. The next_page_token value returned from a previous List request, if any.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for ListDomains.
  "domains": [ # The domains that have been registered by the user.
    { # Information about a domain registered by the user.
      "createTime": "A String", # Output only. Immutable. The timestamp at which the domain was added to the user's account.
      "lastVerifyTime": "A String", # The timestamp at which the domain was last verified by the user.
      "name": "A String", # Identifier. The resource name of the domain. Format: `domains/{domain_name}`, where domain_name is the fully qualified domain name (i.e., mymail.mydomain.com).
      "permission": "A String", # Output only. User's permission of this domain.
      "verificationState": "A String", # Output only. Information about a user's verification history and properties for the domain.
    },
  ],
  "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
}

list_next()

Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.