Skip to content

Users Photo

Ross Scroggs edited this page Feb 22, 2025 · 3 revisions

Users - Photo

API documentation

Definitions

Upload a user's photo from a default file

gam <UserTypeEntity> update photo
  • The default file is named #email#.#ext# in the current working directory.
    • #email# will be replaced by the user's full email address

Upload a user's photo specifying file name

gam <UserTypeEntity> update photo <FileNamePattern>

By default, the user's photo will be uploaded from the current working directory.

  • <FileNamePattern> can be a full file path/name or just a file name
    • #email# and #user# will be replaced by the user's full email address
    • #username# will be replaced by the local part of the user's email address

Upload a user's photo specifying separate path and file name

gam <UserTypeEntity> update photo
        [drivedir|(sourcefolder <FilePath>)] [filename <FileNamePattern>]

By default, the user's photo will be uploaded from the current working directory.

  • drivedir - The photo will be uploaded from the directory specified by drive_dir in gam.cfg

  • sourcefolder <FilePath> - The photo will be uploaded from <FilePath>

  • filename <FileNamePattern> - A file name

    • #email# and #user# will be replaced by the user's full email address
    • #username# will be replaced by the local part of the user's email address

Upload a user's photo specifying a Google Drive owner and file name

gam <UserTypeEntity> update photo
        gphoto <EmailAddress> <DriveFileIDEntity>|<DriveFileNameEntity>
  • <DriveFileIDEntity> - A file ID
  • <DriveFileNameEntity> - A file name
    • #email# and #user# will be replaced by the user's full email address
    • #username# will be replaced by the local part of the user's email address

Download a user's photo

gam <UserTypeEntity> get photo
        [drivedir|(targetfolder <FilePath>)] [filename <FileNamePattern>]
        [noshow] [nofile]

By default, the user's photo will be downloaded into the current working directory.

  • drivedir - The photo will be downloaded to the directory specified by drive_dir in gam.cfg
  • targetfolder <FilePath> - The photo will be downloaded to <FilePath>
  • nofile - Suppress writing the photo data to a file

By default, the user's photo will be named #email#.#ext#; use the following option to specify a different file name.

  • filename <FileNamePattern> - The downloaded file name will be <FileNamePattern>

In either case, the following substitutions will be made:

  • #email# and #user# will be replaced by the user's full email address
  • #username# will be replaced by the local part of the user's email address
  • #ext# will be replaced by the appropriate extension based on the data: jpg, png, gif

By default, the Base64 encoded data is dumped to stdout.

  • noshow - Suppress dumping the photo data to stdout

Delete a user's photo

gam <UserTypeEntity> delete|del photo

oUpdate History

Installation

Configuration

Notes and Information

Definitions

Command Processing

Collections

Client Access

Special Service Account Access

Service Account Access

GAM Tutorials

Clone this wiki locally