g4gdrv_getID
*//////////////////////////////////////////////////////////////*
* g4gdrv_getID - Get ID of Folder or File *
* *
* Output: *
* out_errMsg - The error message (if error exists). *
* *
* Returns: *
* *ERR for error, the Google File/Folder ID *
* *
* Settable Variables ([r]=required) *
* id - Google ID [r] *
* search_title - The fully qualified name of the file or *
* folder to search for (case sensitive) [r] *
* search_type - The type of object to earch for. Valid *
* values are "drive", "folder" and "file" or any value *
* from the G4GCTTPF file. *
* in_drive_id - The id of the shared drive the object *
* resides in. Leave blank to specify your personal drive. *
* in_parent_id - The id of the folder the object resides *
* in (for file only) *
* shortcut_id_type - Specify "target" to return the actual *
* ID of the item the shortcut points to (default), or set *
* this value to "shortcut" to return the actual shortcut of *
* the shortcut. *
* trashed - To search for files in trash or not. Blank *
* will return transhed and not trashed, "true" will return *
* only trashed, and "false" (default) will return only *
* files that are NOT in the trash. *
* ccsid - The CCSID to use (1252) *
* debug - Turn on Debug (*NO, *YES) *
* debug_file - The debug file name. *
* (/tmp/g4g_[id]_listGroupsDebug.txt) *
* *
*//////////////////////////////////////////////////////////////*
D g4gdrv_getID...
D PR 256
D out_errMsg 256 Options(*NOPASS)
g4gdrv_getID will return the Google File ID for the item specified
Returns: Google File ID for the folder or file, blank for error.
Optional Parameters:
Error Message (output) - Error message
Settable Variables (use g4gdrv_setValue):
id (required) - Your Google ID
search_title - The fully qualified name of the file or folder to search for (case sensitive).
search_type - The type of object to search for. Valid values are "drive" for a shared drive, "file" for file and "folder" for folder. Any value from the G4GCTTPF may also be used to search for specific MIME types.
in_drive_id - If you are searching for a folder or file ID in a shared drive, first use this to get the ID of the shared drive, then send the shared drive ID in this field.
in_parent_id - The id of the folder that the file resides in. This is only valid when searching for type "file".
shortcut_id_type - The value of "target" (default) will return target ID of the actual object will be returned. Change this value to "shortcut" to retrieve the actual ID of the shortcut itself.
trashed - Whether or not to search the trash. Blank will search files both in the trash and not in the trash. "true" will search only the trash, and "false" will search only files that are NOT in the trash.
ccsid - The CCSID to use. The default is 1252.
debug - Specify *YES to turn on debug, or *NO to turn off debug. The default is *NO.
debug_file - Specify the fully qualified file name for the main debug file. The default is /tmp/g4g_[id]_listGroupsDebug.txt