Email API. What does the 'source' attribute represent?

[Ray Allen]

In the API code examples, I'm seeing the attribute 'source', with required value 'your-apps'. What does this mean? What should I substitute 'your-apps' with in practice?

client = gdata.apps.emailsettings.client.EmailSettingsClient(domain='yourdomain')
client.ClientLogin(email='adminUsername@yourdomain', password='adminPassword', source='your-apps')
client.UpdateSignature(username='liz', signature="Liz Jones - (+1) 619-555-5555" + "Accounts Management, A&Z LTD.") 

[Claudio Cherubino]

Hi Ray,

The source element is a string used to uniquely identify your application.
We usually recommend to set its value to the name of the application using the APIs, but you can use any value.

By making it unique, though, you are allowing us to easily identify your requests in case of errors so that we can help troubleshoot issues.

Thanks

Claudio

--
You received this message because you are subscribed to the Google Groups "Google Apps Domain Information and Management APIs" group.
To view this discussion on the web visit https://groups.google.com/d/msg/google-apps-mgmt-apis/-/ce4f6XZ381oJ.
To post to this group, send email to google-app...@googlegroups.com.
To unsubscribe from this group, send email to google-apps-mgmt...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/google-apps-mgmt-apis?hl=en.

[Ray Allen]

Hi Claudio,

That makes perfect sense. Thanks very much for the explanation - much appreciated.

Ray

On Thursday, 5 April 2012 22:16:29 UTC+1, Claudio Cherubino wrote:

Hi Ray,

The source element is a string used to uniquely identify your application.
We usually recommend to set its value to the name of the application using the APIs, but you can use any value.

By making it unique, though, you are allowing us to easily identify your requests in case of errors so that we can help troubleshoot issues.

Thanks

Claudio

On Thu, Apr 5, 2012 at 12:44 PM, Ray Allen <ray....@thirdwayit.co.uk> wrote:

In the API code examples, I'm seeing the attribute 'source', with required value 'your-apps'. What does this mean? What should I substitute 'your-apps' with in practice?

client = gdata.apps.emailsettings.client.EmailSettingsClient(domain='yourdomain')


client.ClientLogin(email='adminUsername@yourdomain', password='adminPassword', source='your-apps')


client.UpdateSignature(username='liz', signature="Liz Jones - (+1) 619-555-5555" + "Accounts Management, A&Z LTD.") 

--
You received this message because you are subscribed to the Google Groups "Google Apps Domain Information and Management APIs" group.
To view this discussion on the web visit https://groups.google.com/d/msg/google-apps-mgmt-apis/-/ce4f6XZ381oJ.

To post to this group, send email to google-apps-mgmt-apis@googlegroups.com.
To unsubscribe from this group, send email to google-apps-mgmt-apis+unsub...@googlegroups.com.