Google Apps Security and Compliance Services Web Services Application Programming Interface Guide, Early Access Version 1.5 - Manual (Page 11)

8 Message Security and Filtering Application Programming Interface Guide RELEASE EA version 1.5
API Infrastructure -- Common features across the web services
• API Infrastructure-- A unique license key identifier required for each of your
web service applications. It is used during the authentication of a web service
call. This is a required feature. To get your API license key, send mail to the
Early Access Program’s support, [email protected] to open a
case via email. For technical information, see “API License Key” on page 19.
• Exception Management -- Operation specific exceptions and common
transport-level exceptions are defined by type. This allows for stable and
consistent error handling within your applications. See “Exception
Management” on page 20.
Endpoint Resolver Web Service -- Dynamically returns the location of a web
service on a user’s home system, allowing an API developer to implement cross-
cluster applications. This web service is also useful for validating a user’s domain.
See “About the Endpoint Resolver” on page 25.
Service Management API -- Expands the automated capabilities of the standard
batch command interface while maintaining fine grain control over organizations,
users, and domains. In addition, the Service Management API commands issue
reports, perform transaction authentication, and test the connectivity between the
client application and the server.
While the Service Management API has the same command set as the v.1.0 Early
Access web service, the v.1.5 Service Management API infrastructure is scaled
for the enterprise web service solution. In addition, using wrapped document
literal XML, the Service Management API allows greater stability and
programming flexibility. See “About the Service Management API” on page 35.
User Sync API -- Provides bulk user management for your email security service
account. The API is optimized to efficiently retrieve, add, modify, and delete a
large number of users. In comparison, the Service Management API, while having
similar functionality, primarily provides detailed user management functions for a
single user record. For more information, see the “User Sync API” on page 39.
Google Web Services API Protocols
The Google Web Services API provides human-readable remote procedure calls
using XML/SOAP over HTTPS.
Your application begins a synchronous web service session by making a request
to the server hosting the web service. The server, in turn, responds. For this
request and response transaction to be successful with all possible types of
Internet client applications, the web service must be language and platform
independent.