blob: c789825aff57ffb95e692c87b3fdc9ff7450fc00 [file] [log] [blame] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="gmailpostmastertools_v2.html">Gmail Postmaster Tools API</a> . <a href="gmailpostmastertools_v2.domains.html">domains</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="gmailpostmastertools_v2.domains.domainStats.html">domainStats()</a></code>
</p>
<p class="firstline">Returns the domainStats Resource.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">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.</p>
<p class="toc_element">
<code><a href="#getComplianceStatus">getComplianceStatus(name, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves the compliance status for a given domain. Returns PERMISSION_DENIED if you don't have permission to access compliance status for the domain.</p>
<p class="toc_element">
<code><a href="#list">list(pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">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.</p>
<p class="toc_element">
<code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
<pre>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.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Immutable. The timestamp at which the domain was added to the user&#x27;s account.
&quot;lastVerifyTime&quot;: &quot;A String&quot;, # The timestamp at which the domain was last verified by the user.
&quot;name&quot;: &quot;A String&quot;, # 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).
&quot;permission&quot;: &quot;A String&quot;, # Output only. User&#x27;s permission of this domain.
&quot;verificationState&quot;: &quot;A String&quot;, # Output only. Information about a user&#x27;s verification history and properties for the domain.
}</pre>
</div>
<div class="method">
<code class="details" id="getComplianceStatus">getComplianceStatus(name, x__xgafv=None)</code>
<pre>Retrieves the compliance status for a given domain. Returns PERMISSION_DENIED if you don&#x27;t have permission to access compliance status for the domain.
Args:
name: string, Required. The resource name of the domain&#x27;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.
&quot;complianceData&quot;: { # 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`.
&quot;domainId&quot;: &quot;A String&quot;, # Domain that this data is for.
&quot;honorUnsubscribeVerdict&quot;: { # Compliance verdict for whether a sender meets the unsubscribe honoring compliance requirement. # Unsubscribe honoring compliance verdict.
&quot;reason&quot;: &quot;A String&quot;, # The specific reason for the compliance verdict. Must be empty if the status is compliant.
&quot;status&quot;: { # The status of a sender compliance requirement. # The compliance status.
&quot;status&quot;: &quot;A String&quot;, # Output only. The compliance status.
},
},
&quot;oneClickUnsubscribeVerdict&quot;: { # Compliance verdict for whether a sender meets the one-click unsubscribe compliance requirement. # One-click unsubscribe compliance verdict.
&quot;reason&quot;: &quot;A String&quot;, # The specific reason for the compliance verdict. Must be empty if the status is compliant.
&quot;status&quot;: { # The status of a sender compliance requirement. # The compliance status.
&quot;status&quot;: &quot;A String&quot;, # Output only. The compliance status.
},
},
&quot;rowData&quot;: [ # 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.
&quot;requirement&quot;: &quot;A String&quot;, # The compliance requirement.
&quot;status&quot;: { # The status of a sender compliance requirement. # The compliance status for the requirement.
&quot;status&quot;: &quot;A String&quot;, # Output only. The compliance status.
},
},
],
},
&quot;name&quot;: &quot;A String&quot;, # Identifier. The resource name of the domain&#x27;s compliance status. Format: `domains/{domain_id}/complianceStatus`.
&quot;subdomainComplianceData&quot;: { # 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.
&quot;domainId&quot;: &quot;A String&quot;, # Domain that this data is for.
&quot;honorUnsubscribeVerdict&quot;: { # Compliance verdict for whether a sender meets the unsubscribe honoring compliance requirement. # Unsubscribe honoring compliance verdict.
&quot;reason&quot;: &quot;A String&quot;, # The specific reason for the compliance verdict. Must be empty if the status is compliant.
&quot;status&quot;: { # The status of a sender compliance requirement. # The compliance status.
&quot;status&quot;: &quot;A String&quot;, # Output only. The compliance status.
},
},
&quot;oneClickUnsubscribeVerdict&quot;: { # Compliance verdict for whether a sender meets the one-click unsubscribe compliance requirement. # One-click unsubscribe compliance verdict.
&quot;reason&quot;: &quot;A String&quot;, # The specific reason for the compliance verdict. Must be empty if the status is compliant.
&quot;status&quot;: { # The status of a sender compliance requirement. # The compliance status.
&quot;status&quot;: &quot;A String&quot;, # Output only. The compliance status.
},
},
&quot;rowData&quot;: [ # 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.
&quot;requirement&quot;: &quot;A String&quot;, # The compliance requirement.
&quot;status&quot;: { # The status of a sender compliance requirement. # The compliance status for the requirement.
&quot;status&quot;: &quot;A String&quot;, # Output only. The compliance status.
},
},
],
},
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>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.
&quot;domains&quot;: [ # The domains that have been registered by the user.
{ # Information about a domain registered by the user.
&quot;createTime&quot;: &quot;A String&quot;, # Output only. Immutable. The timestamp at which the domain was added to the user&#x27;s account.
&quot;lastVerifyTime&quot;: &quot;A String&quot;, # The timestamp at which the domain was last verified by the user.
&quot;name&quot;: &quot;A String&quot;, # 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).
&quot;permission&quot;: &quot;A String&quot;, # Output only. User&#x27;s permission of this domain.
&quot;verificationState&quot;: &quot;A String&quot;, # Output only. Information about a user&#x27;s verification history and properties for the domain.
},
],
&quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more results in the list.
}</pre>
</div>
<div class="method">
<code class="details" id="list_next">list_next()</code>
<pre>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 &#x27;execute()&#x27; on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>