Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 1 | |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| 3 | <html><head><title>Python: class Resource</title> |
| 4 | </head><body bgcolor="#f0f0f8"> |
| 5 | <p> |
| 6 | <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| 7 | <tr bgcolor="#ffc8d8"> |
| 8 | <td colspan=3 valign=bottom> <br> |
| 9 | <font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr> |
| 10 | |
| 11 | <tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> |
| 12 | <td colspan=2><tt>A class for interacting with a resource.<br> </tt></td></tr> |
| 13 | <tr><td> </td> |
| 14 | <td width="100%">Methods defined here:<br> |
| 15 | <dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl> |
| 16 | |
| 17 | <dl><dt><a name="Resource-delete"><strong>delete</strong></a> = method(self, **kwargs)</dt><dd><tt>Relinquish ownership of a website or domain.<br> |
| 18 | <br> |
| 19 | Args:<br> |
| 20 | id: string, The id of a verified site or domain. (required)</tt></dd></dl> |
| 21 | |
| 22 | <dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Get the most current data for a website or domain.<br> |
| 23 | <br> |
| 24 | Args:<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 25 | id: string, The id of a verified site or domain. (required)<br> |
| 26 | <br> |
| 27 | Returns:<br> |
| 28 | An object of the form<br> |
| 29 | <br> |
| 30 | {<br> |
| 31 | "owners": [ # The email addresses of all verified owners.<br> |
| 32 | "A String",<br> |
| 33 | ],<br> |
| 34 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 35 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 36 | "identifier": "A String", # 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.<br> |
| 37 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 38 | },<br> |
| 39 | }</tt></dd></dl> |
Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 40 | |
| 41 | <dl><dt><a name="Resource-getToken"><strong>getToken</strong></a> = method(self, **kwargs)</dt><dd><tt>Get a verification token for placing on a website or domain.<br> |
| 42 | <br> |
| 43 | Args:<br> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 44 | verificationMethod: string, The method to use for verifying a site or domain.<br> |
| 45 | identifier: string, The URL or domain to verify.<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 46 | type: string, Type of resource to verify. Can be 'site' (URL) or 'inet_domain' (domain name).<br> |
| 47 | <br> |
| 48 | Returns:<br> |
| 49 | An object of the form<br> |
| 50 | <br> |
| 51 | {<br> |
| 52 | "token": "A String", # The verification token. The token must be placed appropriately in order for verification to succeed.<br> |
| 53 | "method": "A String", # 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.<br> |
| 54 | }</tt></dd></dl> |
Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 55 | |
| 56 | <dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Attempt verification of a website or domain.<br> |
| 57 | <br> |
| 58 | Args:<br> |
| 59 | body: object, The request body. (required)<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 60 | The object takes the form of:<br> |
| 61 | <br> |
| 62 | {<br> |
| 63 | "owners": [ # The email addresses of all verified owners.<br> |
| 64 | "A String",<br> |
| 65 | ],<br> |
| 66 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 67 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 68 | "identifier": "A String", # 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.<br> |
| 69 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 70 | },<br> |
| 71 | }<br> |
| 72 | <br> |
| 73 | verificationMethod: string, The method to use for verifying a site or domain. (required)<br> |
| 74 | <br> |
| 75 | Returns:<br> |
| 76 | An object of the form<br> |
| 77 | <br> |
| 78 | {<br> |
| 79 | "owners": [ # The email addresses of all verified owners.<br> |
| 80 | "A String",<br> |
| 81 | ],<br> |
| 82 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 83 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 84 | "identifier": "A String", # 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.<br> |
| 85 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 86 | },<br> |
| 87 | }</tt></dd></dl> |
Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 88 | |
| 89 | <dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Get the list of your verified websites and domains.<br> |
| 90 | <br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 91 | Args:<br> |
| 92 | <br> |
| 93 | Returns:<br> |
| 94 | An object of the form<br> |
| 95 | <br> |
| 96 | {<br> |
| 97 | "items": [ # The list of sites that are owned by the authenticated user.<br> |
| 98 | {<br> |
| 99 | "owners": [ # The email addresses of all verified owners.<br> |
| 100 | "A String",<br> |
| 101 | ],<br> |
| 102 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 103 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 104 | "identifier": "A String", # 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.<br> |
| 105 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 106 | },<br> |
| 107 | },<br> |
| 108 | ],<br> |
| 109 | }</tt></dd></dl> |
Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 110 | |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 111 | <dl><dt><a name="Resource-patch"><strong>patch</strong></a> = method(self, **kwargs)</dt><dd><tt>Modify the list of owners for your website or domain. This method supports patch semantics.<br> |
| 112 | <br> |
| 113 | Args:<br> |
| 114 | body: object, The request body. (required)<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 115 | The object takes the form of:<br> |
| 116 | <br> |
| 117 | {<br> |
| 118 | "owners": [ # The email addresses of all verified owners.<br> |
| 119 | "A String",<br> |
| 120 | ],<br> |
| 121 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 122 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 123 | "identifier": "A String", # 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.<br> |
| 124 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 125 | },<br> |
| 126 | }<br> |
| 127 | <br> |
| 128 | id: string, The id of a verified site or domain. (required)<br> |
| 129 | <br> |
| 130 | Returns:<br> |
| 131 | An object of the form<br> |
| 132 | <br> |
| 133 | {<br> |
| 134 | "owners": [ # The email addresses of all verified owners.<br> |
| 135 | "A String",<br> |
| 136 | ],<br> |
| 137 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 138 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 139 | "identifier": "A String", # 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.<br> |
| 140 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 141 | },<br> |
| 142 | }</tt></dd></dl> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 143 | |
Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 144 | <dl><dt><a name="Resource-update"><strong>update</strong></a> = method(self, **kwargs)</dt><dd><tt>Modify the list of owners for your website or domain.<br> |
| 145 | <br> |
| 146 | Args:<br> |
| 147 | body: object, The request body. (required)<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 148 | The object takes the form of:<br> |
| 149 | <br> |
| 150 | {<br> |
| 151 | "owners": [ # The email addresses of all verified owners.<br> |
| 152 | "A String",<br> |
| 153 | ],<br> |
| 154 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 155 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 156 | "identifier": "A String", # 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.<br> |
| 157 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 158 | },<br> |
| 159 | }<br> |
| 160 | <br> |
| 161 | id: string, The id of a verified site or domain. (required)<br> |
| 162 | <br> |
| 163 | Returns:<br> |
| 164 | An object of the form<br> |
| 165 | <br> |
| 166 | {<br> |
| 167 | "owners": [ # The email addresses of all verified owners.<br> |
| 168 | "A String",<br> |
| 169 | ],<br> |
| 170 | "id": "A String", # The string used to identify this site. This value should be used in the "id" portion of the REST URL for the Get, Update, and Delete operations.<br> |
| 171 | "site": { # The address and type of a site that is verified or will be verified.<br> |
| 172 | "identifier": "A String", # 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.<br> |
| 173 | "type": "A String", # The site type. Can be SITE or INET_DOMAIN (domain name).<br> |
| 174 | },<br> |
| 175 | }</tt></dd></dl> |
Joe Gregorio | 351b149 | 2011-05-08 23:32:46 -0700 | [diff] [blame] | 176 | |
| 177 | <hr> |
| 178 | Data descriptors defined here:<br> |
| 179 | <dl><dt><strong>__dict__</strong></dt> |
| 180 | <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| 181 | </dl> |
| 182 | <dl><dt><strong>__weakref__</strong></dt> |
| 183 | <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| 184 | </dl> |
| 185 | </td></tr></table> |
| 186 | </body></html> |