Google Apps Domain Shared Contact Connector

Overview

A Google Domain Shared Contact connector is a reading, writing, deleting and polling connector provided by UNIFYBroker/Google Apps. 

This connector encapsulates the information that is available through the Google Apps shared contact API. 

Technical Requirements

If the use of the externalId field in the Flattened Fields schema (see below) are not required, the Google User connector has no additional requirements following that listed connector prerequisites.

If this field is to be used, to function correctly it requires all externalIds associated with a contact to have their label and relation attributes set. 

Usage

A Google Domain Shared Contact connector encapsulates contact data which is made available through the Google Apps shared contacts API.

Schema

The Domain Shared Contact connector provides two Schema Providers, Default and Flattened Fields.

Default Schema Provider

Fields in a Google Domain Shared Contact connector refer to data fields in the Google Apps shared contact API of the same name. Several data points which return multiple value are stored as Multi-value Strings.

Flattened Fields Schema Provider

The Default schema provides three fields which can be repackaged with the use of the Flattened Fields Schema: externalIds, primaryEmail and primaryOrganization.

In the case of primaryEmail and primaryOrganization, the attributes for these fields are extracted and made available as individual fields. The naming convention of these fields is FlattenedPrimaryEmail:<attributeName> and FlattenedPrimaryOrganization:<attributeName>.

For the externalIds field, the Flattened Fields schema contains FlattenedExternalId:ExampleRelation+ExampleLabel. This field does not get assigned directly, but act as a template using the relation and label attributes. The value of each externalId is placed into a field matching its relation and label attributes. At the time of writing, an error is produced by Google if the relation and label are both provided - this can be avoided by only configuring one of them.

Configuration

The configuration for a Google Domain Shared Contact connector is as follows:

Google Scopes

The service account does not require additional scopes.

XML Field Schema

Several fields in the Domain Shared Contact connector are XML formatted strings. The schema for each of these XML blobs are listed below