blob: ea6ce77155c4678081c2bea65968ff123118c9d7 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -04001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="siteVerification_v1.html">Google Site Verification API</a> . <a href="siteVerification_v1.webResource.html">webResource</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#delete">delete(id)</a></code></p>
79<p class="firstline">Relinquish ownership of a website or domain.</p>
80<p class="toc_element">
81 <code><a href="#get">get(id)</a></code></p>
82<p class="firstline">Get the most current data for a website or domain.</p>
83<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070084 <code><a href="#getToken">getToken(body=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040085<p class="firstline">Get a verification token for placing on a website or domain.</p>
86<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070087 <code><a href="#insert">insert(verificationMethod, body=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040088<p class="firstline">Attempt verification of a website or domain.</p>
89<p class="toc_element">
90 <code><a href="#list">list()</a></code></p>
91<p class="firstline">Get the list of your verified websites and domains.</p>
92<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070093 <code><a href="#patch">patch(id, body=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040094<p class="firstline">Modify the list of owners for your website or domain. This method supports patch semantics.</p>
95<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070096 <code><a href="#update">update(id, body=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040097<p class="firstline">Modify the list of owners for your website or domain.</p>
98<h3>Method Details</h3>
99<div class="method">
100 <code class="details" id="delete">delete(id)</code>
101 <pre>Relinquish ownership of a website or domain.
102
103Args:
104 id: string, The id of a verified site or domain. (required)
105</pre>
106</div>
107
108<div class="method">
109 <code class="details" id="get">get(id)</code>
110 <pre>Get the most current data for a website or domain.
111
112Args:
113 id: string, The id of a verified site or domain. (required)
114
115Returns:
116 An object of the form:
117
118 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700119 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
120 &quot;owners&quot;: [ # The email addresses of all verified owners.
121 &quot;A String&quot;,
122 ],
123 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
124 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
125 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
126 },
127 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400128</div>
129
130<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700131 <code class="details" id="getToken">getToken(body=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400132 <pre>Get a verification token for placing on a website or domain.
133
134Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700135 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400136 The object takes the form of:
137
138{
Bu Sun Kim65020912020-05-20 12:08:20 -0700139 &quot;site&quot;: { # The site for which a verification token will be generated.
140 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
141 &quot;type&quot;: &quot;A String&quot;, # The type of resource to be verified. Can be SITE or INET_DOMAIN (domain name).
John Asmuth614db982014-04-24 15:46:26 -0400142 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700143 &quot;verificationMethod&quot;: &quot;A String&quot;, # The verification method that will be used to verify this site. For sites, &#x27;FILE&#x27; or &#x27;META&#x27; methods may be used. For domains, only &#x27;DNS&#x27; may be used.
John Asmuth614db982014-04-24 15:46:26 -0400144 }
145
146
147Returns:
148 An object of the form:
149
150 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700151 &quot;method&quot;: &quot;A String&quot;, # The verification method to use in conjunction with this token. For FILE, the token should be placed in the top-level directory of the site, stored inside a file of the same name. For META, the token should be placed in the HEAD tag of the default page that is loaded for the site. For DNS, the token should be placed in a TXT record of the domain.
152 &quot;token&quot;: &quot;A String&quot;, # The verification token. The token must be placed appropriately in order for verification to succeed.
John Asmuth614db982014-04-24 15:46:26 -0400153 }</pre>
154</div>
155
156<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700157 <code class="details" id="insert">insert(verificationMethod, body=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400158 <pre>Attempt verification of a website or domain.
159
160Args:
161 verificationMethod: string, The method to use for verifying a site or domain. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700162 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400163 The object takes the form of:
164
165{
Bu Sun Kim65020912020-05-20 12:08:20 -0700166 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
167 &quot;owners&quot;: [ # The email addresses of all verified owners.
168 &quot;A String&quot;,
169 ],
170 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
171 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
172 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
173 },
174}
John Asmuth614db982014-04-24 15:46:26 -0400175
176
177Returns:
178 An object of the form:
179
180 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700181 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
182 &quot;owners&quot;: [ # The email addresses of all verified owners.
183 &quot;A String&quot;,
184 ],
185 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
186 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
187 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
188 },
189 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400190</div>
191
192<div class="method">
193 <code class="details" id="list">list()</code>
194 <pre>Get the list of your verified websites and domains.
195
196Args:
197
198Returns:
199 An object of the form:
200
201 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700202 &quot;items&quot;: [ # The list of sites that are owned by the authenticated user.
John Asmuth614db982014-04-24 15:46:26 -0400203 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700204 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
205 &quot;owners&quot;: [ # The email addresses of all verified owners.
206 &quot;A String&quot;,
207 ],
208 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
209 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
210 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
John Asmuth614db982014-04-24 15:46:26 -0400211 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700212 },
John Asmuth614db982014-04-24 15:46:26 -0400213 ],
214 }</pre>
215</div>
216
217<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700218 <code class="details" id="patch">patch(id, body=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400219 <pre>Modify the list of owners for your website or domain. This method supports patch semantics.
220
221Args:
222 id: string, The id of a verified site or domain. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700223 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400224 The object takes the form of:
225
226{
Bu Sun Kim65020912020-05-20 12:08:20 -0700227 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
228 &quot;owners&quot;: [ # The email addresses of all verified owners.
229 &quot;A String&quot;,
230 ],
231 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
232 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
233 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
234 },
235}
John Asmuth614db982014-04-24 15:46:26 -0400236
237
238Returns:
239 An object of the form:
240
241 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700242 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
243 &quot;owners&quot;: [ # The email addresses of all verified owners.
244 &quot;A String&quot;,
245 ],
246 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
247 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
248 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
249 },
250 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400251</div>
252
253<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700254 <code class="details" id="update">update(id, body=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400255 <pre>Modify the list of owners for your website or domain.
256
257Args:
258 id: string, The id of a verified site or domain. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700259 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400260 The object takes the form of:
261
262{
Bu Sun Kim65020912020-05-20 12:08:20 -0700263 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
264 &quot;owners&quot;: [ # The email addresses of all verified owners.
265 &quot;A String&quot;,
266 ],
267 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
268 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
269 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
270 },
271}
John Asmuth614db982014-04-24 15:46:26 -0400272
273
274Returns:
275 An object of the form:
276
277 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700278 &quot;id&quot;: &quot;A String&quot;, # The string used to identify this site. This value should be used in the &quot;id&quot; portion of the REST URL for the Get, Update, and Delete operations.
279 &quot;owners&quot;: [ # The email addresses of all verified owners.
280 &quot;A String&quot;,
281 ],
282 &quot;site&quot;: { # The address and type of a site that is verified or will be verified.
283 &quot;identifier&quot;: &quot;A String&quot;, # The site identifier. If the type is set to SITE, the identifier is a URL. If the type is set to INET_DOMAIN, the site identifier is a domain name.
284 &quot;type&quot;: &quot;A String&quot;, # The site type. Can be SITE or INET_DOMAIN (domain name).
285 },
286 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400287</div>
288
289</body></html>