Skip to main content

contacts

Overview

Namecontacts
TypeResource
Idgoogle.essentialcontacts.contacts

Fields

NameDatatypeDescription
namestringOutput only. The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
validateTimestringThe last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
validationStatestringThe validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
emailstringRequired. The email address to send notifications to. The email address does not need to be a Google Account.
languageTagstringRequired. The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
notificationCategorySubscriptionsarrayRequired. The categories of notifications that the contact will receive communications for.

Methods

NameAccessible byRequired ParamsDescription
folders_contacts_getSELECTcontactsId, foldersIdGets a single contact.
folders_contacts_listSELECTfoldersIdLists the contacts that have been set on a resource.
organizations_contacts_getSELECTcontactsId, organizationsIdGets a single contact.
organizations_contacts_listSELECTorganizationsIdLists the contacts that have been set on a resource.
projects_contacts_getSELECTcontactsId, projectsIdGets a single contact.
projects_contacts_listSELECTprojectsIdLists the contacts that have been set on a resource.
folders_contacts_createINSERTfoldersIdAdds a new contact for a resource.
organizations_contacts_createINSERTorganizationsIdAdds a new contact for a resource.
projects_contacts_createINSERTprojectsIdAdds a new contact for a resource.
folders_contacts_deleteDELETEcontactsId, foldersIdDeletes a contact.
organizations_contacts_deleteDELETEcontactsId, organizationsIdDeletes a contact.
projects_contacts_deleteDELETEcontactsId, projectsIdDeletes a contact.
_folders_contacts_listEXECfoldersIdLists the contacts that have been set on a resource.
_organizations_contacts_listEXECorganizationsIdLists the contacts that have been set on a resource.
_projects_contacts_listEXECprojectsIdLists the contacts that have been set on a resource.
folders_contacts_computeEXECfoldersIdLists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.
folders_contacts_patchEXECcontactsId, foldersIdUpdates a contact. Note: A contact's email address cannot be changed.
folders_contacts_send_test_messageEXECfoldersIdAllows a contact admin to send a test message to contact to verify that it has been configured correctly.
organizations_contacts_computeEXECorganizationsIdLists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.
organizations_contacts_patchEXECcontactsId, organizationsIdUpdates a contact. Note: A contact's email address cannot be changed.
organizations_contacts_send_test_messageEXECorganizationsIdAllows a contact admin to send a test message to contact to verify that it has been configured correctly.
projects_contacts_computeEXECprojectsIdLists all contacts for the resource that are subscribed to the specified notification categories, including contacts inherited from any parent resources.
projects_contacts_patchEXECcontactsId, projectsIdUpdates a contact. Note: A contact's email address cannot be changed.
projects_contacts_send_test_messageEXECprojectsIdAllows a contact admin to send a test message to contact to verify that it has been configured correctly.