G Suite Developers Blog

Unshare domain user’s contact information programmatically using the Google Apps Profiles API

August 31, 2011

Google Apps Provisioning APIGoogle Apps Profiles APIContacts Managerautocomplete

gContact:status<gcontact:status indexed="true"/>indexedfalsedeveloper’s guide.article

Alain Vongsouvanh profile | events

Alain is a Developer Programs Engineer for Google Apps with a focus on Google Calendar and Google Contacts. Before Google, he graduated with his Masters in Computer Science from EPITA, France.

Want to weigh in on this topic? Discuss on Buzz

Using Google Tasks API and OAuth 2.0 on Android

August 29, 2011

pre.code br { display: none; }AccountManagerSettings > Accounts & sync

Accounts registered in your Android environmentAccountManagerAccountManagerGoogleAccountManagerGoogle APIs Client library for JavaGoogleAccountManager googleAccountManager = new GoogleAccountManager(
activity);
Account[] accounts = accountManager.getAccounts();AccountManagerAccountManager.getAuthToken()AccountManagerAccountManagerCallbackgoogleAccountManager.manager.getAuthToken(account, AUTH_TOKEN_TYPE, null,
activity, new AccountManagerCallback<Bundle>() {
public void run(AccountManagerFuture<Bundle> future) {
try {
// If the user has authorized your application to use the tasks API
// a token is available.
String token = future.getResult().getString(
AccountManager.KEY_AUTHTOKEN);
// Now you can use the Tasks API...
useTasksAPI(token);
} catch (OperationCanceledException e) {
// TODO: The user has denied you access to the API, you
// should handle that
} catch (Exception e) {
handleException(e);
}
}
}, null);AccountManagerAUTH_TOKEN_TYPEAccountManagerString AUTH_TOKEN_TYPE = ”Manage your tasks”;AccountManager.getAuthToken()AccountManagerAllowDeny

Authorization dialogAPI KeyAPI KeyGoogle APIs ConsoleAPI Access > Simple API Access > API KeyAPI KeyuseTasksAPI(String accessToken) {
// Setting up the Tasks API Service
HttpTransport transport = AndroidHttp.newCompatibleTransport();
AccessProtectedResource accessProtectedResource =
new GoogleAccessProtectedResource(accessToken);
Tasks service = new Tasks(transport, accessProtectedResource,
new JacksonFactory());
service.setKey(INSERT_YOUR_API_KEY);
service.setApplicationName("Google-TasksSample/1.0");

// TODO: now use the service to query the Tasks API
}serviceTasks API developer’s Guidearticlesamplegetting started

Nicolas Garnier profile | twitter | events

Nicolas joined Google’s Developer Relations in 2008. Since then he's worked on commerce oriented products such as Google Checkout and Google Base. Currently, he is working on Google Apps with a focus on the Google Calendar API, the Google Contacts API, and the Tasks API. Before joining Google, Nicolas worked at Airbus and at the French Space Agency where he built web applications for scientific researchers.

Want to weigh in on this topic? Discuss on Buzz

Rich signatures for your domain using the Email Settings and the Profiles APIs

August 23, 2011

pre.code br { display:none; }recent additionGoogle Apps Profiles APIGoogle Data APIs Python Client LibraryAdvanced Tools - Manage OAuth domain keyimport gdata.apps.emailsettings.client
import gdata.contacts.client
# replace these values with yours

CONSUMER_KEY = 'mydomain.com'
CONSUMER_SECRET = 'my_consumer_secret'
company_name = 'ACME Inc.'
admin_username = 'admin'2-legged OAuthxoauth_requestor_id# request a 2-legged OAuth token
requestor_id = admin_username + '@' + CONSUMER_KEY
two_legged_oauth_token = gdata.gauth.TwoLeggedOAuthHmacToken(
CONSUMER_KEY, CONSUMER_SECRET, requestor_id)

# Email Settings API client
email_settings_client = gdata.apps.emailsettings.client.EmailSettingsClient(
domain=CONSUMER_KEY)
email_settings_client.auth_token = two_legged_oauth_token

# User Profiles API client
profiles_client = gdata.contacts.client.ContactsClient(
domain=CONSUMER_KEY)
profiles_client.auth_token = two_legged_oauth_tokenHtmlSignature()# helper class used to build signatures
class SignatureBuilder(object):
def HtmlSignature(self):
signature = '%s' % self.name
if self.occupation:
signature += '%s' % self.occupation
if self.company:
signature += '%s' % self.company
signature += 'Email: <a href=\'mailto:%s\'>%s</a> - Phone: %s' % (
self.email, self.email, self.phone_number)
return signature

def __init__(
self, name, company='', occupation='', email='', phone_number=''):
self.name = name
self.company = company
self.occupation = occupation
self.email = email
self.phone_number = phone_numberGetProfilesFeed()next# get all user profiles for the domain
profiles = []
feed_uri = profiles_client.GetFeedUri('profiles')
while feed_uri:
feed = profiles_client.GetProfilesFeed(uri=feed_uri)
profiles.extend(feed.entry)
feed_uri = feed.FindNextLink()
SignatureBuildernamecompanyoccupationemailphone_number# extract relevant pieces of data for each profile
for entry in profiles:
builder = SignatureBuilder(entry.name.full_name.text)
builder.company = company_name
if entry.occupation:
builder.occupation = entry.occupation.text
for email in entry.email:
if email.primary and email.primary == 'true':
builder.email = email.address
for number in entry.phone_number:
if number.primary and number.primary == 'true':
builder.phone_number = number.text

# build the signature
signature = builder.HtmlSignature()UpdateSignatureProvisioning API# entry.id has the following structure:
# http://www.google.com/m8/feeds/profiles/domain/DOMAIN_NAME/full/USERNAME
# the username is the string that follows the last /
username = entry.id.text[entry.id.text.rfind('/')+1:]# set the user's signature using the Email Settings API
email_settings_client.UpdateSignature(username=username,
signature=signature)documentationforums

Claudio Cherubino profile | twitter | blog

Claudio is a Developer Programs Engineer working on Google Apps APIs and the Google Apps Marketplace. Prior to Google, he worked as software developer, technology evangelist, community manager, consultant, technical translator and has contributed to many open-source projects, including MySQL, PHP, Wordpress, Songbird and Project Voldemort.

Learn about Google Apps Script in NYC

July 28, 2011

Google Apps Script

Gmail Snooze with Apps Script

Content Approval Workflow

Vacation calendar management

Helpdesk Workflow

Time Booking

Google Apps Script HackathonWhatApps Script HackathonDateTimeWhereRegisterhere
For those who cannot attend in person, we invite you to try out a number of self-paced tutorials on the Apps Script documentation site.

Saurabh Gupta profile | twitter | blog

Saurabh is a Developer Programs Engineer at Google. He works closely with Google Apps Script developers to help them extend Google Apps. Over the last 10 years, he has worked in the financial services industry in different roles. His current mission is to bring automation and collaboration to Google Apps users.

Gmail Snooze with Apps Script

July 27, 2011

pre.code br { display: none; }inbox zeroWhat is Gmail Snooze?The Solutionvar MARK_UNREAD = false;
var ADD_UNSNOOZED_LABEL = false;SetupNote:setup()refreshfunction getLabelName(i) {
return "Snooze/Snooze " + i + " days";
}

function setup() {
// Create the labels we’ll need for snoozing
GmailApp.createLabel("Snooze");
for (var i = 1; i <= 7; ++i) {
GmailApp.createLabel(getLabelName(i));
}
if (ADD_UNSNOOZED_LABEL) {
GmailApp.createLabel("Unsnoozed");
}
}Moving the Snooze Queueevent triggerfunction moveSnoozes() {
var oldLabel, newLabel, page;
for (var i = 1; i <= 7; ++i) {
newLabel = oldLabel;
oldLabel = GmailApp.getUserLabelByName(getLabelName(i));
page = null;
// Get threads in "pages" of 100 at a time
while(!page || page.length == 100) {
page = oldLabel.getThreads(0, 100);
if (page.length > 0) {
if (newLabel) {
// Move the threads into "today’s" label
newLabel.addToThreads(page);
} else {
// Unless it’s time to unsnooze it
GmailApp.moveThreadsToInbox(page);
if (MARK_UNREAD) {
GmailApp.markThreadsUnread(page);
}
if (ADD_UNSNOOZED_LABEL) {
GmailApp.getUserLabelByName("Unsnoozed")
.addToThreads(page);
}
}
// Move the threads out of "yesterday’s" label
oldLabel.removeFromThreads(page);
}
}
}
}Using Snooze Label in GmailIf you don't know how to setup a script, it's pretty simple. Create a new Google Spreadsheet, and choose "Script Editor" from the "Tools" menu. Paste in all of the code from above and then click the “Save” button and give it a name. In the dropdown labeled "Select a function to run," choose "setup" and click the blue run arrow to the left of it. This will ask you to authorize the script, and will create the necessary labels in your Gmail. Then go to the "Triggers" menu and choose "current script's triggers." Click the link to set up a new trigger, choosing the "moveSnoozes" function, a "time-driven" event, "day timer," and then "midnight to 1am." Click save and you are done.

Corey Goldfeder profile

Corey is a Google software engineer on the Apps Script Project, based in New York. He has previously worked on Similar Shape search for 3DWarehouse, and as a robotics researcher before joining Google.

Updated: 7/29/2011 to add additional instructions for refreshing the Gmail window after running the setup() function

Improved Sync - Announcing the Changes Feed in the Documents List API

July 14, 2011

Changes feedapp:editedhttps://docs.google.com/feeds/default/private/changes<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
xmlns:docs="http://schemas.google.com/docs/2007"
xmlns:gd="http://schemas.google.com/g/2005"
gd:etag="W/"DEEMQ3w8eyt7ImA9WhZUGUo."">
<docs:largestChangestamp>5635</docs:largestChangestamp>
<link rel="next" type="application/atom+xml"
href="...?start-index=5636"/>
<entry gd:etag="W/"DUcMRHg5cCt7ImA9WhZUGUo."">
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/docs/2007#change"
label="change"/>
<title>Project tasks</title>
...
<docs:changestamp value="5623"/>
</entry>
...
</feed>developer guideforum

Russ Jorgensen LinkedIn

Russ Jorgensen joined Google in 2010 and is responsible for supporting and enhancing APIs which third-party applications can use to access and manage users' collections of Google Docs. Prior to working at Google, Russ was an embedded software engineer for 22 years at Bell Labs building telecommunications products such as PBXs and wireless communication systems.

Want to weigh in on this topic? Discuss on Buzz

Using 2-legged OAuth with the Google Tasks API for Google Apps domain administrators

July 7, 2011

launchGoogle Tasks API

Any use of the Tasks API needs to reference a project in the APIs Console, as the Console is used to manage API quotas and other application settings (such as IP filters).

The Tasks API needs to be explicitly enabled for your domain OAuth key and secret.

Referencing an APIs Console ProjectAPIs ConsoleAPI Keykeyhttps://www.googleapis.com/tasks/v1/users/username/lists?key=<API_KEY>Java client libraryTasks// Initializing the Tasks API service
Tasks service = new Tasks("2-LO Tasks Test", httpTransport, jsonFactory);
service.accessKey = API_KEY;Enabling the Tasks API for your domain OAuth key and secretManage OAuth domain keyEnable this consumer keycheckedAllow access to all APIsunchecked

Setting up the domain OAuth consumer key and secretManage third party OAuth Client accesshttps://www.google.com/calendar/feeds/, https://www.googleapis.com/auth/tasksUsing 2-Legged OAuth with Google Tasks API for Google Apps domain administrators

Nicolas Garnier profile | twitter | events

Want to weigh in on this topic? Discuss on Buzz