blob: 5fb70511fdad62a7dac6f869174019443e467d02 [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
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080075<h1><a href="reseller_v1.html">Google Workspace Reseller API</a> . <a href="reseller_v1.customers.html">customers</a></h1>
John Asmuth614db982014-04-24 15:46:26 -040076<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">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080081 <code><a href="#get">get(customerId, x__xgafv=None)</a></code></p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080082<p class="firstline">Get a customer account. Use this operation to see a customer account already in your reseller management, or to see the minimal account information for an existing customer that you do not manage. For more information about the API response for existing customers, see [retrieving a customer account](/admin-sdk/reseller/v1/how-tos/manage_customers#get_customer).</p>
John Asmuth614db982014-04-24 15:46:26 -040083<p class="toc_element">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080084 <code><a href="#insert">insert(body=None, customerAuthToken=None, x__xgafv=None)</a></code></p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080085<p class="firstline">Order a new customer's account. Before ordering a new customer account, establish whether the customer account already exists using the [`customers.get`](/admin-sdk/reseller/v1/reference/customers/get) If the customer account exists as a direct Google account or as a resold customer account from another reseller, use the `customerAuthToken\` as described in [order a resold account for an existing customer](/admin-sdk/reseller/v1/how-tos/manage_customers#create_existing_customer). For more information about ordering a new customer account, see [order a new customer account](/admin-sdk/reseller/v1/how-tos/manage_customers#create_customer). After creating a new customer account, you must provision a user as an administrator. The customer's administrator is required to sign in to the Admin console and sign the G Suite via Reseller agreement to activate the account. Resellers are prohibited from signing the G Suite via Reseller agreement on the customer's behalf. For more information, see [order a new customer account](/admin-sdk/reseller/v1/how-tos/manage_customers#tos).</p>
John Asmuth614db982014-04-24 15:46:26 -040086<p class="toc_element">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080087 <code><a href="#patch">patch(customerId, body=None, x__xgafv=None)</a></code></p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080088<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">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080090 <code><a href="#update">update(customerId, body=None, x__xgafv=None)</a></code></p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080091<p class="firstline">Update a customer account's settings. For more information, see [update a customer's settings](/admin-sdk/reseller/v1/how-tos/manage_customers#update_customer).</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">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080099 <code class="details" id="get">get(customerId, x__xgafv=None)</code>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800100 <pre>Get a customer account. Use this operation to see a customer account already in your reseller management, or to see the minimal account information for an existing customer that you do not manage. For more information about the API response for existing customers, see [retrieving a customer account](/admin-sdk/reseller/v1/how-tos/manage_customers#get_customer).
John Asmuth614db982014-04-24 15:46:26 -0400101
102Args:
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800103 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)
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800104 x__xgafv: string, V1 error format.
105 Allowed values
106 1 - v1 error format
107 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400108
109Returns:
110 An object of the form:
111
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800112 { # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
113 &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`.
114 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800115 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
116 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800117 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800118 &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.
119 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800120 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800121 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
122 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
123 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800124 &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.
125 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
126 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800127 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800128 &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.
129 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800130 },
131 &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.
132}</pre>
John Asmuth614db982014-04-24 15:46:26 -0400133</div>
134
135<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800136 <code class="details" id="insert">insert(body=None, customerAuthToken=None, x__xgafv=None)</code>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800137 <pre>Order a new customer&#x27;s account. Before ordering a new customer account, establish whether the customer account already exists using the [`customers.get`](/admin-sdk/reseller/v1/reference/customers/get) If the customer account exists as a direct Google account or as a resold customer account from another reseller, use the `customerAuthToken\` as described in [order a resold account for an existing customer](/admin-sdk/reseller/v1/how-tos/manage_customers#create_existing_customer). For more information about ordering a new customer account, see [order a new customer account](/admin-sdk/reseller/v1/how-tos/manage_customers#create_customer). After creating a new customer account, you must provision a user as an administrator. The customer&#x27;s administrator is required to sign in to the Admin console and sign the G Suite via Reseller agreement to activate the account. Resellers are prohibited from signing the G Suite via Reseller agreement on the customer&#x27;s behalf. For more information, see [order a new customer account](/admin-sdk/reseller/v1/how-tos/manage_customers#tos).
John Asmuth614db982014-04-24 15:46:26 -0400138
139Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700140 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400141 The object takes the form of:
142
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800143{ # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
144 &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`.
145 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800146 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
147 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800148 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800149 &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.
150 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800151 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800152 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
153 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
154 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800155 &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.
156 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
157 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800158 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800159 &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.
160 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800161 },
162 &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.
163}
John Asmuth614db982014-04-24 15:46:26 -0400164
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800165 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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800166 x__xgafv: string, V1 error format.
167 Allowed values
168 1 - v1 error format
169 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400170
171Returns:
172 An object of the form:
173
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800174 { # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
175 &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`.
176 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800177 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
178 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800179 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800180 &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.
181 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800182 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800183 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
184 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
185 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800186 &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.
187 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
188 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800189 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800190 &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.
191 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800192 },
193 &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.
194}</pre>
John Asmuth614db982014-04-24 15:46:26 -0400195</div>
196
197<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800198 <code class="details" id="patch">patch(customerId, body=None, x__xgafv=None)</code>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800199 <pre>Update a customer account&#x27;s settings. This method supports patch semantics.
John Asmuth614db982014-04-24 15:46:26 -0400200
201Args:
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800202 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 -0700203 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400204 The object takes the form of:
205
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800206{ # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
207 &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`.
208 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800209 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
210 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800211 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800212 &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.
213 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800214 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800215 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
216 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
217 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800218 &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.
219 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
220 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800221 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800222 &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.
223 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800224 },
225 &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.
226}
John Asmuth614db982014-04-24 15:46:26 -0400227
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800228 x__xgafv: string, V1 error format.
229 Allowed values
230 1 - v1 error format
231 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400232
233Returns:
234 An object of the form:
235
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800236 { # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
237 &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`.
238 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800239 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
240 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800241 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800242 &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;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800244 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800245 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
246 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
247 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800248 &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.
249 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
250 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800251 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800252 &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.
253 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800254 },
255 &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.
256}</pre>
John Asmuth614db982014-04-24 15:46:26 -0400257</div>
258
259<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800260 <code class="details" id="update">update(customerId, body=None, x__xgafv=None)</code>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800261 <pre>Update a customer account&#x27;s settings. For more information, see [update a customer&#x27;s settings](/admin-sdk/reseller/v1/how-tos/manage_customers#update_customer).
John Asmuth614db982014-04-24 15:46:26 -0400262
263Args:
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800264 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 -0700265 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -0400266 The object takes the form of:
267
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800268{ # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
269 &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`.
270 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800271 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
272 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800273 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800274 &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;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800276 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800277 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
278 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
279 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800280 &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.
281 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
282 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800283 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800284 &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.
285 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800286 },
287 &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.
288}
John Asmuth614db982014-04-24 15:46:26 -0400289
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800290 x__xgafv: string, V1 error format.
291 Allowed values
292 1 - v1 error format
293 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400294
295Returns:
296 An object of the form:
297
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800298 { # When a Google customer&#x27;s account is registered with a reseller, the customer&#x27;s subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.
299 &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`.
300 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800301 &quot;customerDomainVerified&quot;: True or False, # Whether the customer&#x27;s primary domain has been verified.
302 &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.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800303 &quot;kind&quot;: &quot;reseller#customer&quot;, # Identifies the resource as a customer. Value: `reseller#customer`
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800304 &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.
305 &quot;postalAddress&quot;: { # JSON template for address of a customer. # A customer&#x27;s address information. Each field has a limit of 255 charcters.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800306 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800307 &quot;addressLine2&quot;: &quot;A String&quot;, # Line 2 of the address.
308 &quot;addressLine3&quot;: &quot;A String&quot;, # Line 3 of the address.
309 &quot;contactName&quot;: &quot;A String&quot;, # The customer contact&#x27;s name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800310 &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.
311 &quot;kind&quot;: &quot;customers#address&quot;, # Identifies the resource as a customer address. Value: `customers#address`
312 &quot;locality&quot;: &quot;A String&quot;, # An example of a `locality` value is the city of `San Francisco`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800313 &quot;organizationName&quot;: &quot;A String&quot;, # The company or company division name. This is required.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800314 &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.
315 &quot;region&quot;: &quot;A String&quot;, # An example of a `region` value is `CA` for the state of California.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800316 },
317 &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.
318}</pre>
John Asmuth614db982014-04-24 15:46:26 -0400319</div>
320
321</body></html>