blob: eb71f38d8ed0a10fcb5b684791331a02908c8e4a [file] [log] [blame]
Craig Citro0e5b9bf2014-10-15 10:26:14 -07001<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
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -080075<h1><a href="webmasters_v3.html">Search Console API</a> . <a href="webmasters_v3.sitemaps.html">sitemaps</a></h1>
Craig Citro0e5b9bf2014-10-15 10:26:14 -070076<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Craig Citro0e5b9bf2014-10-15 10:26:14 -070081 <code><a href="#delete">delete(siteUrl, feedpath)</a></code></p>
82<p class="firstline">Deletes a sitemap from this site.</p>
83<p class="toc_element">
84 <code><a href="#get">get(siteUrl, feedpath)</a></code></p>
85<p class="firstline">Retrieves information about a specific sitemap.</p>
86<p class="toc_element">
87 <code><a href="#list">list(siteUrl, sitemapIndex=None)</a></code></p>
Takashi Matsuo06694102015-09-11 13:55:40 -070088<p class="firstline">Lists the sitemaps-entries submitted for this site, or included in the sitemap index file (if sitemapIndex is specified in the request).</p>
Craig Citro0e5b9bf2014-10-15 10:26:14 -070089<p class="toc_element">
90 <code><a href="#submit">submit(siteUrl, feedpath)</a></code></p>
91<p class="firstline">Submits a sitemap for a site.</p>
92<h3>Method Details</h3>
93<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070094 <code class="details" id="close">close()</code>
95 <pre>Close httplib2 connections.</pre>
96</div>
97
98<div class="method">
Craig Citro0e5b9bf2014-10-15 10:26:14 -070099 <code class="details" id="delete">delete(siteUrl, feedpath)</code>
100 <pre>Deletes a sitemap from this site.
101
102Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700103 siteUrl: string, The site&#x27;s URL, including protocol. For example: http://www.example.com/ (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700104 feedpath: string, The URL of the actual sitemap. For example: http://www.example.com/sitemap.xml (required)
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700105</pre>
106</div>
107
108<div class="method">
109 <code class="details" id="get">get(siteUrl, feedpath)</code>
110 <pre>Retrieves information about a specific sitemap.
111
112Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700113 siteUrl: string, The site&#x27;s URL, including protocol. For example: http://www.example.com/ (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700114 feedpath: string, The URL of the actual sitemap. For example: http://www.example.com/sitemap.xml (required)
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700115
116Returns:
117 An object of the form:
118
Takashi Matsuo06694102015-09-11 13:55:40 -0700119 { # Contains detailed information about a specific URL submitted as a sitemap.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800120 &quot;contents&quot;: [ # The various content types in the sitemap.
121 { # Information about the various content types in the sitemap.
122 &quot;indexed&quot;: &quot;A String&quot;, # The number of URLs from the sitemap that were indexed (of the content type).
123 &quot;submitted&quot;: &quot;A String&quot;, # The number of URLs in the sitemap (of the content type).
124 &quot;type&quot;: &quot;A String&quot;, # The specific type of content in this sitemap. For example: web.
125 },
126 ],
127 &quot;errors&quot;: &quot;A String&quot;, # Number of errors in the sitemap. These are issues with the sitemap itself that need to be fixed before it can be processed correctly.
128 &quot;isPending&quot;: True or False, # If true, the sitemap has not been processed.
129 &quot;isSitemapsIndex&quot;: True or False, # If true, the sitemap is a collection of sitemaps.
130 &quot;lastDownloaded&quot;: &quot;A String&quot;, # Date &amp; time in which this sitemap was last downloaded. Date format is in RFC 3339 format (yyyy-mm-dd).
131 &quot;lastSubmitted&quot;: &quot;A String&quot;, # Date &amp; time in which this sitemap was submitted. Date format is in RFC 3339 format (yyyy-mm-dd).
132 &quot;path&quot;: &quot;A String&quot;, # The url of the sitemap.
133 &quot;type&quot;: &quot;A String&quot;, # The type of the sitemap. For example: rssFeed.
134 &quot;warnings&quot;: &quot;A String&quot;, # Number of warnings for the sitemap. These are generally non-critical issues with URLs in the sitemaps.
135}</pre>
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700136</div>
137
138<div class="method">
139 <code class="details" id="list">list(siteUrl, sitemapIndex=None)</code>
Takashi Matsuo06694102015-09-11 13:55:40 -0700140 <pre>Lists the sitemaps-entries submitted for this site, or included in the sitemap index file (if sitemapIndex is specified in the request).
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700141
142Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700143 siteUrl: string, The site&#x27;s URL, including protocol. For example: http://www.example.com/ (required)
144 sitemapIndex: string, A URL of a site&#x27;s sitemap index. For example: http://www.example.com/sitemapindex.xml
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700145
146Returns:
147 An object of the form:
148
149 { # List of sitemaps.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800150 &quot;sitemap&quot;: [ # Contains detailed information about a specific URL submitted as a sitemap.
151 { # Contains detailed information about a specific URL submitted as a sitemap.
152 &quot;contents&quot;: [ # The various content types in the sitemap.
153 { # Information about the various content types in the sitemap.
154 &quot;indexed&quot;: &quot;A String&quot;, # The number of URLs from the sitemap that were indexed (of the content type).
155 &quot;submitted&quot;: &quot;A String&quot;, # The number of URLs in the sitemap (of the content type).
156 &quot;type&quot;: &quot;A String&quot;, # The specific type of content in this sitemap. For example: web.
157 },
158 ],
159 &quot;errors&quot;: &quot;A String&quot;, # Number of errors in the sitemap. These are issues with the sitemap itself that need to be fixed before it can be processed correctly.
160 &quot;isPending&quot;: True or False, # If true, the sitemap has not been processed.
161 &quot;isSitemapsIndex&quot;: True or False, # If true, the sitemap is a collection of sitemaps.
162 &quot;lastDownloaded&quot;: &quot;A String&quot;, # Date &amp; time in which this sitemap was last downloaded. Date format is in RFC 3339 format (yyyy-mm-dd).
163 &quot;lastSubmitted&quot;: &quot;A String&quot;, # Date &amp; time in which this sitemap was submitted. Date format is in RFC 3339 format (yyyy-mm-dd).
164 &quot;path&quot;: &quot;A String&quot;, # The url of the sitemap.
165 &quot;type&quot;: &quot;A String&quot;, # The type of the sitemap. For example: rssFeed.
166 &quot;warnings&quot;: &quot;A String&quot;, # Number of warnings for the sitemap. These are generally non-critical issues with URLs in the sitemaps.
167 },
168 ],
169}</pre>
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700170</div>
171
172<div class="method">
173 <code class="details" id="submit">submit(siteUrl, feedpath)</code>
174 <pre>Submits a sitemap for a site.
175
176Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700177 siteUrl: string, The site&#x27;s URL, including protocol. For example: http://www.example.com/ (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700178 feedpath: string, The URL of the sitemap to add. For example: http://www.example.com/sitemap.xml (required)
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700179</pre>
180</div>
181
182</body></html>