How to Automatically Update Gmail Profile Picture of Google Workspace Users

An organisation is running on Google Workspace and, as part of a branding exercise, they need to update the profile pictures of all Gmail users. The Google Workspace admin can use the Admin Directory API with Google Apps Script to update Gmail photos of all users in the domain. The files can be placed in Google Drive and the script can automatically make it the user’s photo.

The Apps Admin Directory API accepts images in JPEG, PNG, GIF, BMP and TIFF formats. The user is identified by their primary email address and the photo’s upload data should be encoded in web-safe Base64 format.

function updateGmailPhotoFromDrive() {
  try {
    var userEmail = 'amit@labnol.org';
    var fileName = userEmail + '.jpg';

    var blob = DriveApp.getFilesByName(fileName).next().getBlob();
    var data = Utilities.base64EncodeWebSafe(blob.getBytes());

    AdminDirectory.Users.Photos.update({ photoData: data }, userEmail);
  } catch (err) {
    Logger.log(err.toString());
  }
}

If an image is on the web (and not on Google Drive), the URL Fetch service can be used to make it the user’s photo.

function updateGmailPhotoFromWeb() {
  try {
    var userEmail = 'amit@labnol.org';
    var webURL = 'https://ctrlq.org/assets/ctrlq.org.png';

    var blob = UrlFetchApp.fetch(webURL).getBlob();
    var data = Utilities.base64EncodeWebSafe(blob.getBytes());

    AdminDirectory.Users.Photos.update({ photoData: data }, userEmail);
  } catch (err) {
    Logger.log(err.toString());
  }
}

Amit Agarwal is a web geek, solo entrepreneur and loves making things on the Internet. Google recently awarded him the Google Developer Expert and Google Cloud Champion title for his work on Google Workspace and Google Apps Script.

Awards & Recognition

Google Developer Expert

Google Developer Expert

Google awarded us the Developer Expert title recogizing our work in Workspace

ProductHunt Golden Kitty

ProductHunt Golden Kitty

Our Gmail tool won the Lifehack of the Year award at ProductHunt Golden Kitty Awards

Microsoft MVP Alumni

Microsoft MVP Alumni

Microsoft awarded us the Most Valuable Professional title for 5 years in a row

Google Cloud Champion

Google Cloud Champion

Google awarded us the Champion Innovator award for technical expertise

Want to stay up to date?
Sign up for our email newsletter.

We will never send any spam emails. Promise 🫶🏻