blob: bfc914f11f7c3646cedbd12bfcd1317c9611b205 [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="reseller_v1.html">Enterprise Apps Reseller API</a> . <a href="reseller_v1.customers.html">customers</a></h1>
76<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">
John Asmuth614db982014-04-24 15:46:26 -040081 <code><a href="#get">get(customerId)</a></code></p>
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -040082<p class="firstline">Get a customer account.</p>
John Asmuth614db982014-04-24 15:46:26 -040083<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070084 <code><a href="#insert">insert(body=None, customerAuthToken=None)</a></code></p>
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -040085<p class="firstline">Order a new customer's account.</p>
John Asmuth614db982014-04-24 15:46:26 -040086<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070087 <code><a href="#patch">patch(customerId, body=None)</a></code></p>
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -040088<p class="firstline">Update a customer account's settings. This method supports patch semantics.</p>
John Asmuth614db982014-04-24 15:46:26 -040089<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070090 <code><a href="#update">update(customerId, body=None)</a></code></p>
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -040091<p class="firstline">Update a customer account's settings.</p>
John Asmuth614db982014-04-24 15:46:26 -040092<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">
John Asmuth614db982014-04-24 15:46:26 -040099 <code class="details" id="get">get(customerId)</code>
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400100 <pre>Get a customer account.
John Asmuth614db982014-04-24 15:46:26 -0400101
102Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700103 customerId: string, Either the customer&#x27;s primary domain name or the customer&#x27;s unique identifier. If using the domain name, we do not recommend using a customerId as a key for persistent data. If the domain name for a customerId is changed, the Google system automatically updates. (required)
John Asmuth614db982014-04-24 15:46:26 -0400104
105Returns:
106 An object of the form:
107
108 { # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700109 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700110 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700111 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700112 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700113 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700114 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700115 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
116 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
117 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
118 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
119 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700120 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
121 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700122 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
123 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700124 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700125 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
126 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
127 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700128 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400129</div>
130
131<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700132 <code class="details" id="insert">insert(body=None, customerAuthToken=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700133 <pre>Order a new customer&#x27;s account.
John Asmuth614db982014-04-24 15:46:26 -0400134
135Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700136 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400137 The object takes the form of:
138
139{ # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700140 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700141 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700142 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700143 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700144 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700145 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700146 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
147 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
148 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
149 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
150 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700151 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
152 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700153 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
154 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700155 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700156 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
157 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
158 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700159 }
John Asmuth614db982014-04-24 15:46:26 -0400160
Bu Sun Kim65020912020-05-20 12:08:20 -0700161 customerAuthToken: string, The customerAuthToken query string is required when creating a resold account that transfers a direct customer&#x27;s subscription or transfers another reseller customer&#x27;s subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.
John Asmuth614db982014-04-24 15:46:26 -0400162
163Returns:
164 An object of the form:
165
166 { # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700167 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700168 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700169 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700170 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700171 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700172 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700173 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
174 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
175 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
176 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
177 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700178 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
179 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700180 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
181 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700182 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700183 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
184 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
185 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700186 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400187</div>
188
189<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700190 <code class="details" id="patch">patch(customerId, body=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700191 <pre>Update a customer account&#x27;s settings. This method supports patch semantics.
John Asmuth614db982014-04-24 15:46:26 -0400192
193Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700194 customerId: string, Either the customer&#x27;s primary domain name or the customer&#x27;s unique identifier. If using the domain name, we do not recommend using a customerId as a key for persistent data. If the domain name for a customerId is changed, the Google system automatically updates. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700195 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400196 The object takes the form of:
197
198{ # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700199 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700200 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700201 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700202 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700203 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700204 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700205 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
206 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
207 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
208 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
209 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700210 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
211 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700212 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
213 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700214 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700215 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
216 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
217 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700218 }
John Asmuth614db982014-04-24 15:46:26 -0400219
220
221Returns:
222 An object of the form:
223
224 { # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700225 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700226 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700227 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700228 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700229 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700230 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700231 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
232 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
233 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
234 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
235 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700236 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
237 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700238 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
239 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700240 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700241 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
242 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
243 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700244 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400245</div>
246
247<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700248 <code class="details" id="update">update(customerId, body=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700249 <pre>Update a customer account&#x27;s settings.
John Asmuth614db982014-04-24 15:46:26 -0400250
251Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700252 customerId: string, Either the customer&#x27;s primary domain name or the customer&#x27;s unique identifier. If using the domain name, we do not recommend using a customerId as a key for persistent data. If the domain name for a customerId is changed, the Google system automatically updates. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700253 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400254 The object takes the form of:
255
256{ # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700257 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700258 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700259 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700260 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700261 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700262 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700263 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
264 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
265 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
266 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
267 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700268 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
269 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700270 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
271 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700272 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700273 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
274 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
275 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700276 }
John Asmuth614db982014-04-24 15:46:26 -0400277
278
279Returns:
280 An object of the form:
281
282 { # JSON template for a customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700283 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700284 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700285 &quot;countryCode&quot;: &quot;A String&quot;, # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700286 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700287 &quot;addressLine1&quot;: &quot;A String&quot;, # A customer&#x27;s physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700288 &quot;locality&quot;: &quot;A String&quot;, # An example of a locality value is the city of San Francisco.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700289 &quot;region&quot;: &quot;A String&quot;, # An example of a region value is CA for the state of California.
290 &quot;postalCode&quot;: &quot;A String&quot;, # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
291 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
292 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: customers#address
293 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700294 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
295 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700296 &quot;customerDomain&quot;: &quot;A String&quot;, # The customer&#x27;s primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
297 &quot;alternateEmail&quot;: &quot;A String&quot;, # Like the &quot;Customer email&quot; in the reseller tools, this email is the secondary contact used if something happens to the customer&#x27;s service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700298 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: reseller#customer
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700299 &quot;resourceUiUrl&quot;: &quot;A String&quot;, # URL to customer&#x27;s Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
300 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer contact phone number. Must start with &quot;+&quot; followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, &quot;123&quot;. This field is silently ignored if invalid.
301 &quot;customerId&quot;: &quot;A String&quot;, # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700302 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400303</div>
304
305</body></html>