blob: b7c621a2d7e313bffe309ea64a34eb898008e0f8 [file] [log] [blame]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="admin_directory_v1.html">Admin Directory API</a> . <a href="admin_directory_v1.customers.html">customers</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#get">get(customerKey)</a></code></p>
<p class="firstline">Retrieves a customer.</p>
<p class="toc_element">
<code><a href="#patch">patch(customerKey, body)</a></code></p>
<p class="firstline">Updates a customer. This method supports patch semantics.</p>
<p class="toc_element">
<code><a href="#update">update(customerKey, body)</a></code></p>
<p class="firstline">Updates a customer.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="get">get(customerKey)</code>
<pre>Retrieves a customer.
Args:
customerKey: string, Id of the customer to be retrieved (required)
Returns:
An object of the form:
{ # JSON template for Customer Resource object in Directory API.
"customerDomain": "A String", # The customer's primary domain name string. Do not include the www prefix when creating a new customer.
"language": "A String", # The customer's ISO 639-2 language code. The default value is en-US
"alternateEmail": "A String", # The customer's secondary contact email address. This email address cannot be on the same domain as the customerDomain
"customerCreationTime": "A String", # The customer's creation time (Readonly)
"kind": "admin#directory#customer", # Identifies the resource as a customer. Value: admin#directory#customer
"etag": "A String", # ETag of the resource.
"phoneNumber": "A String", # The customer's contact phone number in E.164 format.
"postalAddress": { # JSON template for postal address of a customer. # The customer's postal address information.
"organizationName": "A String", # The company or company division name.
"countryCode": "A String", # This is a required property. For countryCode information see the ISO 3166 country code elements.
"locality": "A String", # Name of the locality. An example of a locality value is the city of San Francisco.
"region": "A String", # Name of the region. An example of a region value is NY for the state of New York.
"addressLine2": "A String", # Address line 2 of the address.
"addressLine3": "A String", # Address line 3 of the address.
"contactName": "A String", # The customer contact's name.
"addressLine1": "A String", # A customer's physical address. The address can be composed of one to three lines.
"postalCode": "A String", # The postal code. A postalCode example is a postal zip code such as 10009. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element.
},
"id": "A String", # The unique ID for the customer's Google account. (Readonly)
}</pre>
</div>
<div class="method">
<code class="details" id="patch">patch(customerKey, body)</code>
<pre>Updates a customer. This method supports patch semantics.
Args:
customerKey: string, Id of the customer to be updated (required)
body: object, The request body. (required)
The object takes the form of:
{ # JSON template for Customer Resource object in Directory API.
"customerDomain": "A String", # The customer's primary domain name string. Do not include the www prefix when creating a new customer.
"language": "A String", # The customer's ISO 639-2 language code. The default value is en-US
"alternateEmail": "A String", # The customer's secondary contact email address. This email address cannot be on the same domain as the customerDomain
"customerCreationTime": "A String", # The customer's creation time (Readonly)
"kind": "admin#directory#customer", # Identifies the resource as a customer. Value: admin#directory#customer
"etag": "A String", # ETag of the resource.
"phoneNumber": "A String", # The customer's contact phone number in E.164 format.
"postalAddress": { # JSON template for postal address of a customer. # The customer's postal address information.
"organizationName": "A String", # The company or company division name.
"countryCode": "A String", # This is a required property. For countryCode information see the ISO 3166 country code elements.
"locality": "A String", # Name of the locality. An example of a locality value is the city of San Francisco.
"region": "A String", # Name of the region. An example of a region value is NY for the state of New York.
"addressLine2": "A String", # Address line 2 of the address.
"addressLine3": "A String", # Address line 3 of the address.
"contactName": "A String", # The customer contact's name.
"addressLine1": "A String", # A customer's physical address. The address can be composed of one to three lines.
"postalCode": "A String", # The postal code. A postalCode example is a postal zip code such as 10009. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element.
},
"id": "A String", # The unique ID for the customer's Google account. (Readonly)
}
Returns:
An object of the form:
{ # JSON template for Customer Resource object in Directory API.
"customerDomain": "A String", # The customer's primary domain name string. Do not include the www prefix when creating a new customer.
"language": "A String", # The customer's ISO 639-2 language code. The default value is en-US
"alternateEmail": "A String", # The customer's secondary contact email address. This email address cannot be on the same domain as the customerDomain
"customerCreationTime": "A String", # The customer's creation time (Readonly)
"kind": "admin#directory#customer", # Identifies the resource as a customer. Value: admin#directory#customer
"etag": "A String", # ETag of the resource.
"phoneNumber": "A String", # The customer's contact phone number in E.164 format.
"postalAddress": { # JSON template for postal address of a customer. # The customer's postal address information.
"organizationName": "A String", # The company or company division name.
"countryCode": "A String", # This is a required property. For countryCode information see the ISO 3166 country code elements.
"locality": "A String", # Name of the locality. An example of a locality value is the city of San Francisco.
"region": "A String", # Name of the region. An example of a region value is NY for the state of New York.
"addressLine2": "A String", # Address line 2 of the address.
"addressLine3": "A String", # Address line 3 of the address.
"contactName": "A String", # The customer contact's name.
"addressLine1": "A String", # A customer's physical address. The address can be composed of one to three lines.
"postalCode": "A String", # The postal code. A postalCode example is a postal zip code such as 10009. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element.
},
"id": "A String", # The unique ID for the customer's Google account. (Readonly)
}</pre>
</div>
<div class="method">
<code class="details" id="update">update(customerKey, body)</code>
<pre>Updates a customer.
Args:
customerKey: string, Id of the customer to be updated (required)
body: object, The request body. (required)
The object takes the form of:
{ # JSON template for Customer Resource object in Directory API.
"customerDomain": "A String", # The customer's primary domain name string. Do not include the www prefix when creating a new customer.
"language": "A String", # The customer's ISO 639-2 language code. The default value is en-US
"alternateEmail": "A String", # The customer's secondary contact email address. This email address cannot be on the same domain as the customerDomain
"customerCreationTime": "A String", # The customer's creation time (Readonly)
"kind": "admin#directory#customer", # Identifies the resource as a customer. Value: admin#directory#customer
"etag": "A String", # ETag of the resource.
"phoneNumber": "A String", # The customer's contact phone number in E.164 format.
"postalAddress": { # JSON template for postal address of a customer. # The customer's postal address information.
"organizationName": "A String", # The company or company division name.
"countryCode": "A String", # This is a required property. For countryCode information see the ISO 3166 country code elements.
"locality": "A String", # Name of the locality. An example of a locality value is the city of San Francisco.
"region": "A String", # Name of the region. An example of a region value is NY for the state of New York.
"addressLine2": "A String", # Address line 2 of the address.
"addressLine3": "A String", # Address line 3 of the address.
"contactName": "A String", # The customer contact's name.
"addressLine1": "A String", # A customer's physical address. The address can be composed of one to three lines.
"postalCode": "A String", # The postal code. A postalCode example is a postal zip code such as 10009. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element.
},
"id": "A String", # The unique ID for the customer's Google account. (Readonly)
}
Returns:
An object of the form:
{ # JSON template for Customer Resource object in Directory API.
"customerDomain": "A String", # The customer's primary domain name string. Do not include the www prefix when creating a new customer.
"language": "A String", # The customer's ISO 639-2 language code. The default value is en-US
"alternateEmail": "A String", # The customer's secondary contact email address. This email address cannot be on the same domain as the customerDomain
"customerCreationTime": "A String", # The customer's creation time (Readonly)
"kind": "admin#directory#customer", # Identifies the resource as a customer. Value: admin#directory#customer
"etag": "A String", # ETag of the resource.
"phoneNumber": "A String", # The customer's contact phone number in E.164 format.
"postalAddress": { # JSON template for postal address of a customer. # The customer's postal address information.
"organizationName": "A String", # The company or company division name.
"countryCode": "A String", # This is a required property. For countryCode information see the ISO 3166 country code elements.
"locality": "A String", # Name of the locality. An example of a locality value is the city of San Francisco.
"region": "A String", # Name of the region. An example of a region value is NY for the state of New York.
"addressLine2": "A String", # Address line 2 of the address.
"addressLine3": "A String", # Address line 3 of the address.
"contactName": "A String", # The customer contact's name.
"addressLine1": "A String", # A customer's physical address. The address can be composed of one to three lines.
"postalCode": "A String", # The postal code. A postalCode example is a postal zip code such as 10009. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element.
},
"id": "A String", # The unique ID for the customer's Google account. (Readonly)
}</pre>
</div>
</body></html>