Google Apps Security and Compliance Services Web Services Bedienungsanleitung PDF herunterladen (Seite 30)

28 Message Security and Compliance Application Programming Interface Guide RELEASE EA version 1.5

See Also

“AutomatedBatch Reference Basics” on page 36, “About the User Sync API” on

page 39.

Operation

GetServiceEndpoint

Request: GetServiceEndpoint <apiKey> <email> <service>

Response:

Description

Performs a lookup using the specified email address. The operation maps the

cluster returned into the appropriate endpoint URI.

apiKey -- A global unique 48 character string identifying the customer and the

client application. For more information, see “API License Key” on page 19.

email -- A user’s email address as type string, for example

msmith@jumboinc.com.

service -- v2AutomatedBatch. For more information about AutomatedBatch,

see “AutomatedBatch Reference Basics” on page 36.

Note: The Endpoint Resolver web service is not recommended for use with

JAX.WS 2.0.

Response

Either an Endpoint URL is returned or an exception.

Description

EndpointURI returns a string:

<service type> (<exception> | <service end point URL>)

Exceptions

When handling exceptions, use the exception name (example:

AdminBlockException). Any exception strings should not be used to identify an

exception. These strings are subject to change across releases.

API Infrastructure Exceptions

• AdminBlockException -- Specified API license key blocked for

Administrative Reasons

• InternalException -- Internal exceptions caused by server-side problems

• InvalidValueException -- One or more element values does not validate.

• MalformedKeyException -- Malformed API license key

• MissingElementException -- One or more required elements is missing

from the input.

• NoSuchKeyException -- Specified API license key does not Exist

• UnknownEmailException -- Specified email cannot be located in our

system. See “Validating a Domain” on page 26

• UnknownInternalException -- Exceptions caused by unhandled server-side

problems

See “Exception Management” on page 20.

1 2 ... 25 26 27 28 29 30 31 32 33 34 35 ... 69 70

Keine Kommentare

Google Apps Security and Compliance Services Web Services Bedienungsanleitung Seite 30