domains
Creates, updates, deletes, gets or lists a domains resource.
Overview
| Name | domains |
| Type | Resource |
| Id | googleadmin.directory.domains |
Fields
The following fields are returned by SELECT queries:
- get
- list
| Name | Datatype | Description |
|---|---|---|
creationTime | string (int64) | Creation time of the domain. Expressed in Unix time format. (Read-only). |
domainAliases | array | A list of domain alias objects. (Read-only) |
domainName | string | The domain name of the customer. |
etag | string | ETag of the resource. |
isPrimary | boolean | Indicates if the domain is a primary domain (Read-only). |
kind | string | Kind of resource this is. (default: admin#directory#domain) |
verified | boolean | Indicates the verification state of a domain. (Read-only). |
| Name | Datatype | Description |
|---|---|---|
domains | array | A list of domain objects. |
etag | string | ETag of the resource. |
kind | string | Kind of resource this is. (default: admin#directory#domains) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | customer, domainName | Retrieves a domain of the customer. | |
list | select | customer | Lists the domains of the customer. | |
insert | insert | customer | Inserts a domain of the customer. | |
delete | delete | customer, domainName | Deletes a domain of the customer. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
customer | string | |
domainName | string |
SELECT examples
- get
- list
Retrieves a domain of the customer.
SELECT
creationTime,
domainAliases,
domainName,
etag,
isPrimary,
kind,
verified
FROM googleadmin.directory.domains
WHERE customer = '{{ customer }}' -- required
AND domainName = '{{ domainName }}' -- required
;
Lists the domains of the customer.
SELECT
domains,
etag,
kind
FROM googleadmin.directory.domains
WHERE customer = '{{ customer }}' -- required
;
INSERT examples
- insert
- Manifest
Inserts a domain of the customer.
INSERT INTO googleadmin.directory.domains (
data__domainAliases,
data__creationTime,
data__etag,
data__domainName,
data__kind,
data__verified,
data__isPrimary,
customer
)
SELECT
'{{ domainAliases }}',
'{{ creationTime }}',
'{{ etag }}',
'{{ domainName }}',
'{{ kind }}',
{{ verified }},
{{ isPrimary }},
'{{ customer }}'
RETURNING
creationTime,
domainAliases,
domainName,
etag,
isPrimary,
kind,
verified
;
# Description fields are for documentation purposes
- name: domains
props:
- name: customer
value: "{{ customer }}"
description: Required parameter for the domains resource.
- name: domainAliases
description: |
A list of domain alias objects. (Read-only)
value:
- creationTime: "{{ creationTime }}"
domainAliasName: "{{ domainAliasName }}"
kind: "{{ kind }}"
parentDomainName: "{{ parentDomainName }}"
verified: {{ verified }}
etag: "{{ etag }}"
- name: creationTime
value: "{{ creationTime }}"
description: |
Creation time of the domain. Expressed in [Unix time](https://en.wikipedia.org/wiki/Epoch_time) format. (Read-only).
- name: etag
value: "{{ etag }}"
description: |
ETag of the resource.
- name: domainName
value: "{{ domainName }}"
description: |
The domain name of the customer.
- name: kind
value: "{{ kind }}"
description: |
Kind of resource this is.
default: admin#directory#domain
- name: verified
value: {{ verified }}
description: |
Indicates the verification state of a domain. (Read-only).
- name: isPrimary
value: {{ isPrimary }}
description: |
Indicates if the domain is a primary domain (Read-only).
DELETE examples
- delete
Deletes a domain of the customer.
DELETE FROM googleadmin.directory.domains
WHERE customer = '{{ customer }}' --required
AND domainName = '{{ domainName }}' --required
;