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

10 Message Security and Filtering Application Programming Interface Guide RELEASE EA version 1.5
The Extensible Markup Language (XML) is a markup or tagging language
used to describe data. This allows your application’s data to be persistently
recreated on both the server-side and the client-side of a web service’s
request and response transaction.
• SOAP -- Provides a dependable envelope to pass your web service
transaction across the Internet.
SOAP is a generic messaging framework for XML-based web service
messages. This framework is recognized and accepted by web browsers and
web servers making it easier to pass remote procedure calls through firewalls.
The HTTPS/SOAP transport protocols create a generic envelop wrapping around
your XML-tagged data. And, at the data’s destination, the XML-tagged data is
unwrapped. A more specific term for this wrapping and unwrapping is
serialization. Serialization defines reliable deconstruction and reconstruction of
data streams created by remote procedure calls. The result is the server-side data
is accurately recreated on the client-side, and visa versa.
Using Internationalized Domain Names
Internationalized domain names using native character sets are not supported. All
domain names must be specified by Internet standards to 7-bit ASCII characters.
Converting internationalized domain names using native character sets to 7-bit
ASCII representations is collectively known as Internationalizing Domain Names
in Applications, (IDNA), and is specified in proposed standard RFC 3490. The
most widely accepted native character to 7-bit encoding scheme is Punycode
which is specified in proposed standard RFC 3492.
Note: As a best practice, make all domain names easy to remember words or
character sequences.
If you wish to convert internationalized domain names, you must:
1. Determine your internationalized domain names, including any native
characters.
2. Determine the corresponding punycode 7-bit ASCII representation. Some
convenient resources are:
http://www.nameisp.com/puny.asp
http://punycode.bluerider.com/idn/
3. Register the punycoded domain name with your ISP.
Note: The punycoded domain name is now your official Internet domain name.
4. Always use your punycoded domain name in any application calling the
Google Web Services API.