| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 1 | <html><body> | 
 | 2 | <style> | 
 | 3 |  | 
 | 4 | body, 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 |  | 
 | 15 | body { | 
 | 16 |   font-size: 13px; | 
 | 17 |   padding: 1em; | 
 | 18 | } | 
 | 19 |  | 
 | 20 | h1 { | 
 | 21 |   font-size: 26px; | 
 | 22 |   margin-bottom: 1em; | 
 | 23 | } | 
 | 24 |  | 
 | 25 | h2 { | 
 | 26 |   font-size: 24px; | 
 | 27 |   margin-bottom: 1em; | 
 | 28 | } | 
 | 29 |  | 
 | 30 | h3 { | 
 | 31 |   font-size: 20px; | 
 | 32 |   margin-bottom: 1em; | 
 | 33 |   margin-top: 1em; | 
 | 34 | } | 
 | 35 |  | 
 | 36 | pre, code { | 
 | 37 |   line-height: 1.5; | 
 | 38 |   font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; | 
 | 39 | } | 
 | 40 |  | 
 | 41 | pre { | 
 | 42 |   margin-top: 0.5em; | 
 | 43 | } | 
 | 44 |  | 
 | 45 | h1, h2, h3, p { | 
 | 46 |   font-family: Arial, sans serif; | 
 | 47 | } | 
 | 48 |  | 
 | 49 | h1, 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 Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 78 |   <code><a href="#close">close()</a></code></p> | 
 | 79 | <p class="firstline">Close httplib2 connections.</p> | 
 | 80 | <p class="toc_element"> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 81 |   <code><a href="#get">get(customerId)</a></code></p> | 
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 82 | <p class="firstline">Get a customer account.</p> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 83 | <p class="toc_element"> | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 84 |   <code><a href="#insert">insert(body=None, customerAuthToken=None)</a></code></p> | 
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 85 | <p class="firstline">Order a new customer's account.</p> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 86 | <p class="toc_element"> | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 87 |   <code><a href="#patch">patch(customerId, body=None)</a></code></p> | 
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 88 | <p class="firstline">Update a customer account's settings. This method supports patch semantics.</p> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 89 | <p class="toc_element"> | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 90 |   <code><a href="#update">update(customerId, body=None)</a></code></p> | 
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 91 | <p class="firstline">Update a customer account's settings.</p> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 92 | <h3>Method Details</h3> | 
 | 93 | <div class="method"> | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 94 |     <code class="details" id="close">close()</code> | 
 | 95 |   <pre>Close httplib2 connections.</pre> | 
 | 96 | </div> | 
 | 97 |  | 
 | 98 | <div class="method"> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 99 |     <code class="details" id="get">get(customerId)</code> | 
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 100 |   <pre>Get a customer account. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 101 |  | 
 | 102 | Args: | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 103 |   customerId: string, Either the customer's primary domain name or the customer'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 Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 104 |  | 
 | 105 | Returns: | 
 | 106 |   An object of the form: | 
 | 107 |  | 
 | 108 |     { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 109 |       "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 110 |       "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 111 |         "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 112 |         "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 113 |         "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 114 |         "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 115 |         "region": "A String", # An example of a region value is CA for the state of California. | 
 | 116 |         "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 117 |         "addressLine3": "A String", # Line 3 of the address. | 
 | 118 |         "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 119 |         "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 120 |         "contactName": "A String", # The customer contact's name. This is required. | 
 | 121 |       }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 122 |       "customerDomain": "A String", # The customer'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 |       "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 124 |       "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 125 |       "resourceUiUrl": "A String", # URL to customer'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 |       "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 127 |       "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 128 |     }</pre> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 129 | </div> | 
 | 130 |  | 
 | 131 | <div class="method"> | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 132 |     <code class="details" id="insert">insert(body=None, customerAuthToken=None)</code> | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 133 |   <pre>Order a new customer's account. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 134 |  | 
 | 135 | Args: | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 136 |   body: object, The request body. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 137 |     The object takes the form of: | 
 | 138 |  | 
 | 139 | { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 140 |     "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 141 |     "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 142 |       "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 143 |       "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 144 |       "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 145 |       "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 146 |       "region": "A String", # An example of a region value is CA for the state of California. | 
 | 147 |       "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 148 |       "addressLine3": "A String", # Line 3 of the address. | 
 | 149 |       "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 150 |       "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 151 |       "contactName": "A String", # The customer contact's name. This is required. | 
 | 152 |     }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 153 |     "customerDomain": "A String", # The customer'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 |     "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 155 |     "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 156 |     "resourceUiUrl": "A String", # URL to customer'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 |     "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 158 |     "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 159 |   } | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 160 |  | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 161 |   customerAuthToken: string, The customerAuthToken query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer'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 Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 162 |  | 
 | 163 | Returns: | 
 | 164 |   An object of the form: | 
 | 165 |  | 
 | 166 |     { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 167 |       "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 168 |       "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 169 |         "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 170 |         "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 171 |         "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 172 |         "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 173 |         "region": "A String", # An example of a region value is CA for the state of California. | 
 | 174 |         "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 175 |         "addressLine3": "A String", # Line 3 of the address. | 
 | 176 |         "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 177 |         "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 178 |         "contactName": "A String", # The customer contact's name. This is required. | 
 | 179 |       }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 180 |       "customerDomain": "A String", # The customer'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 |       "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 182 |       "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 183 |       "resourceUiUrl": "A String", # URL to customer'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 |       "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 185 |       "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 186 |     }</pre> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 187 | </div> | 
 | 188 |  | 
 | 189 | <div class="method"> | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 190 |     <code class="details" id="patch">patch(customerId, body=None)</code> | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 191 |   <pre>Update a customer account's settings. This method supports patch semantics. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 192 |  | 
 | 193 | Args: | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 194 |   customerId: string, Either the customer's primary domain name or the customer'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'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 195 |   body: object, The request body. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 196 |     The object takes the form of: | 
 | 197 |  | 
 | 198 | { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 199 |     "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 200 |     "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 201 |       "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 202 |       "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 203 |       "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 204 |       "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 205 |       "region": "A String", # An example of a region value is CA for the state of California. | 
 | 206 |       "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 207 |       "addressLine3": "A String", # Line 3 of the address. | 
 | 208 |       "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 209 |       "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 210 |       "contactName": "A String", # The customer contact's name. This is required. | 
 | 211 |     }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 212 |     "customerDomain": "A String", # The customer'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 |     "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 214 |     "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 215 |     "resourceUiUrl": "A String", # URL to customer'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 |     "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 217 |     "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 218 |   } | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 219 |  | 
 | 220 |  | 
 | 221 | Returns: | 
 | 222 |   An object of the form: | 
 | 223 |  | 
 | 224 |     { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 225 |       "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 226 |       "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 227 |         "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 228 |         "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 229 |         "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 230 |         "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 231 |         "region": "A String", # An example of a region value is CA for the state of California. | 
 | 232 |         "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 233 |         "addressLine3": "A String", # Line 3 of the address. | 
 | 234 |         "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 235 |         "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 236 |         "contactName": "A String", # The customer contact's name. This is required. | 
 | 237 |       }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 238 |       "customerDomain": "A String", # The customer'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 |       "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 240 |       "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 241 |       "resourceUiUrl": "A String", # URL to customer'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 |       "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 243 |       "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 244 |     }</pre> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 245 | </div> | 
 | 246 |  | 
 | 247 | <div class="method"> | 
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 248 |     <code class="details" id="update">update(customerId, body=None)</code> | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 249 |   <pre>Update a customer account's settings. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 250 |  | 
 | 251 | Args: | 
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 252 |   customerId: string, Either the customer's primary domain name or the customer'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'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 253 |   body: object, The request body. | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 254 |     The object takes the form of: | 
 | 255 |  | 
 | 256 | { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 257 |     "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 258 |     "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 259 |       "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 260 |       "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 261 |       "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 262 |       "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 263 |       "region": "A String", # An example of a region value is CA for the state of California. | 
 | 264 |       "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 265 |       "addressLine3": "A String", # Line 3 of the address. | 
 | 266 |       "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 267 |       "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 268 |       "contactName": "A String", # The customer contact's name. This is required. | 
 | 269 |     }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 270 |     "customerDomain": "A String", # The customer'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 |     "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 272 |     "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 273 |     "resourceUiUrl": "A String", # URL to customer'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 |     "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 275 |     "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 276 |   } | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 277 |  | 
 | 278 |  | 
 | 279 | Returns: | 
 | 280 |   An object of the form: | 
 | 281 |  | 
 | 282 |     { # JSON template for a customer. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 283 |       "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 284 |       "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 285 |         "countryCode": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 286 |         "organizationName": "A String", # The company or company division name. This is required. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 287 |         "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 288 |         "locality": "A String", # An example of a locality value is the city of San Francisco. | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 289 |         "region": "A String", # An example of a region value is CA for the state of California. | 
 | 290 |         "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer. | 
 | 291 |         "addressLine3": "A String", # Line 3 of the address. | 
 | 292 |         "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address | 
 | 293 |         "addressLine2": "A String", # Line 2 of the address. | 
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 294 |         "contactName": "A String", # The customer contact's name. This is required. | 
 | 295 |       }, | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 296 |       "customerDomain": "A String", # The customer'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 |       "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer'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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 298 |       "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer | 
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame^] | 299 |       "resourceUiUrl": "A String", # URL to customer'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 |       "phoneNumber": "A String", # Customer contact phone number. Must start with "+" 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, "123". This field is silently ignored if invalid. | 
 | 301 |       "customerId": "A String", # 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 Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 302 |     }</pre> | 
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 303 | </div> | 
 | 304 |  | 
 | 305 | </body></html> |