gam7 7.3.9__py3-none-any.whl → 7.4.1__py3-none-any.whl

gam/__init__.py

@@ -25,7 +25,7 @@ https://github.com/GAM-team/GAM/wiki
 """
 
 __author__ = 'GAM Team <google-apps-manager@googlegroups.com>'
-__version__ = '7.03.09'
+__version__ = '7.04.01'
 __license__ = 'Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0)'
 
 #pylint: disable=wrong-import-position
@@ -142,14 +142,11 @@ from gamlib import glskus as SKU
 from gamlib import gluprop as UProp
 from gamlib import glverlibs
 
-import atom
 import gdata.apps.service
 import gdata.apps.audit
 import gdata.apps.audit.service
 import gdata.apps.contacts
 import gdata.apps.contacts.service
-import gdata.apps.sites
-import gdata.apps.sites.service
 # Import local library, does not include discovery documents
 import googleapiclient
 import googleapiclient.discovery
@@ -670,8 +667,10 @@ def accessErrorExitNonDirectory(api, errMsg):
                                                                 Ent.API, api])+[errMsg],
                                      ''))
 
-def ClientAPIAccessDeniedExit():
+def ClientAPIAccessDeniedExit(errMsg=None):
   stderrErrorMsg(Msg.API_ACCESS_DENIED)
+  if errMsg:
+    stderrErrorMsg(errMsg)
   missingScopes = API.getClientScopesSet(GM.Globals[GM.CURRENT_CLIENT_API])-GM.Globals[GM.CURRENT_CLIENT_API_SCOPES]
   if missingScopes:
     writeStderr(Msg.API_CHECK_CLIENT_AUTHORIZATION.format(GM.Globals[GM.OAUTH2_CLIENT_ID],
@@ -825,6 +824,9 @@ def deprecatedArgument(argument):
 def deprecatedArgumentExit(argument):
   usageErrorExit(f'{Cmd.ARGUMENT_ERROR_NAMES[Cmd.ARGUMENT_DEPRECATED][1]}: <{argument}>')
 
+def deprecatedCommandExit():
+  systemErrorExit(USAGE_ERROR_RC, Msg.SITES_COMMAND_DEPRECATED.format(Cmd.CommandDeprecated()))
+
 # Choices is the valid set of choices that was expected
 def formatChoiceList(choices):
   choiceList = [c if c else "''" for c in choices]
@@ -1749,33 +1751,6 @@ def protectedSheetId(spreadsheet, sheetId):
         return True
   return False
 
-SITENAME_PATTERN = re.compile(r'^[a-z0-9\-_]+$')
-SITENAME_FORMAT_REQUIRED = '[a-z,0-9,-_]+'
-
-def validateSplitSiteName(fullSite):
-  siteParts = fullSite.lower().split('/', 1)
-  if (len(siteParts) == 1) or not siteParts[1]:
-    domain = GC.Values[GC.DOMAIN]
-    site = siteParts[0]
-  elif not siteParts[0]:
-    domain = GC.Values[GC.DOMAIN]
-    site = siteParts[1]
-  else:
-    domain = siteParts[0]
-    site = siteParts[1]
-  if SITENAME_PATTERN.match(site):
-    return (domain, site, f'{domain}/{site}')
-  return (domain, site, None)
-
-def getSiteName():
-  if Cmd.ArgumentsRemaining():
-    domain, site, domainSite = validateSplitSiteName(Cmd.Current())
-    if domainSite:
-      Cmd.Advance()
-      return (domain, site, domainSite)
-    invalidArgumentExit(SITENAME_FORMAT_REQUIRED)
-  missingArgumentExit(SITENAME_FORMAT_REQUIRED)
-
 def getString(item, checkBlank=False, optional=False, minLen=1, maxLen=None):
   if Cmd.ArgumentsRemaining():
     argstr = Cmd.Current()
@@ -5674,21 +5649,6 @@ def getContactsQuery(**kwargs):
 def getEmailAuditObject():
   return initGDataObject(gdata.apps.audit.service.AuditService(), API.EMAIL_AUDIT)
 
-def getSitesObject(entityType=Ent.DOMAIN, entityName=None, i=0, count=0):
-  if entityType == Ent.DOMAIN:
-    sitesObject = initGDataObject(gdata.apps.sites.service.SitesService(), API.SITES)
-    return (entityName or GC.Values[GC.DOMAIN], sitesObject)
-  userEmail, credentials = getGDataUserCredentials(API.SITES, entityName, i, count)
-  if not credentials:
-    return (userEmail, None)
-  if GC.Values[GC.NO_VERIFY_SSL]:
-    ssl._create_default_https_context = ssl._create_unverified_context
-  sitesObject = gdata.apps.sites.service.SitesService(source=GAM_USER_AGENT,
-                                                      additional_headers={'Authorization': f'Bearer {credentials.token}'})
-  if GC.Values[GC.DEBUG_LEVEL] > 0:
-    sitesObject.debug = True
-  return (userEmail, sitesObject)
-
 def getUserEmailFromID(uid, cd):
   try:
     result = callGAPI(cd.users(), 'get',
@@ -21267,6 +21227,8 @@ def _getPeopleOtherContacts(people, entityType, user, i=0, count=0):
       resourceName = contact.pop('resourceName')
       otherContacts[resourceName] = contact
     return otherContacts
+  except GAPI.permissionDenied as e:
+    ClientAPIAccessDeniedExit(str(e))
   except (GAPI.serviceNotAvailable, GAPI.forbidden):
     entityUnknownWarning(entityType, user, i, count)
   return None
@@ -21323,6 +21285,8 @@ def queryPeopleContacts(people, contactQuery, fields, sortOrder, entityType, use
       showMessage = pageMessage.replace(TOTAL_ITEMS_MARKER, str(totalItems))
       writeGotMessage(showMessage.replace('{0}', str(Ent.Choose(Ent.PEOPLE_CONTACT, totalItems))))
     return entityList
+  except GAPI.permissionDenied as e:
+    ClientAPIAccessDeniedExit(str(e))
   except (GAPI.serviceNotAvailable, GAPI.forbidden):
     entityUnknownWarning(entityType, user, i, count)
   return None
@@ -21349,6 +21313,8 @@ def queryPeopleOtherContacts(people, contactQuery, fields, entityType, user, i=0
         showMessage = pageMessage.replace(TOTAL_ITEMS_MARKER, str(totalItems))
         writeGotMessage(showMessage.replace('{0}', str(Ent.Choose(Ent.OTHER_CONTACT, totalItems))))
     return entityList
+  except GAPI.permissionDenied as e:
+    ClientAPIAccessDeniedExit(str(e))
   except (GAPI.serviceNotAvailable, GAPI.forbidden):
     entityUnknownWarning(entityType, user, i, count)
   return None
@@ -21369,6 +21335,8 @@ def getPeopleContactGroupsInfo(people, entityType, entityName, i, count):
         if group['formattedName'] != group['name']:
           contactGroupNames.setdefault(group['name'], [])
           contactGroupNames[group['name']].append(group['resourceName'])
+  except GAPI.permissionDenied as e:
+    ClientAPIAccessDeniedExit(str(e))
   except GAPI.forbidden:
     userPeopleServiceNotEnabledWarning(entityName, i, count)
     return (contactGroupIDs, False)
@@ -21467,6 +21435,8 @@ def createUserPeopleContact(users):
         csvPF.WriteRow(row)
     except GAPI.invalidArgument as e:
       entityActionFailedWarning([entityType, user, peopleEntityType, None], str(e), i, count)
+    except GAPI.permissionDenied as e:
+      ClientAPIAccessDeniedExit(str(e))
     except (GAPI.serviceNotAvailable, GAPI.forbidden):
       ClientAPIAccessDeniedExit()
   if csvPF:
@@ -21630,6 +21600,8 @@ def _clearUpdatePeopleContacts(users, updateContacts):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], str(e), j, jcount)
       except (GAPI.notFound, GAPI.internalError):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], Msg.DOES_NOT_EXIST, j, jcount)
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
       except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
     Ind.Decrement()
@@ -21778,6 +21750,8 @@ def dedupReplaceDomainUserPeopleContacts(users):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], str(e), j, jcount)
       except (GAPI.notFound, GAPI.internalError):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], Msg.DOES_NOT_EXIST, j, jcount)
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
       except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
     Ind.Decrement()
@@ -21831,6 +21805,8 @@ def deleteUserPeopleContacts(users):
         entityActionPerformed([entityType, user, peopleEntityType, resourceName], j, jcount)
       except (GAPI.notFound, GAPI.internalError):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], Msg.DOES_NOT_EXIST, j, jcount)
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
       except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
     Ind.Decrement()
@@ -22109,6 +22085,8 @@ def _infoPeople(users, entityType, source):
       except GAPI.invalidArgument as e:
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], str(e), j, jcount)
         continue
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
       except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
       if showContactGroups and contactGroupIDs:
@@ -22287,6 +22265,8 @@ def copyUserPeopleOtherContacts(users):
       except (GAPI.notFound, GAPI.internalError):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], Msg.DOES_NOT_EXIST, j, jcount)
         continue
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
       except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
     Ind.Decrement()
@@ -22401,7 +22381,9 @@ def processUserPeopleOtherContacts(users):
       except (GAPI.notFound, GAPI.internalError):
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName], Msg.DOES_NOT_EXIST, j, jcount)
         continue
-      except (GAPI.serviceNotAvailable, GAPI.forbidden, GAPI.permissionDenied):
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
+      except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
     Ind.Decrement()
 
@@ -22518,6 +22500,8 @@ def _printShowPeople(source):
                                pageSize=GC.Values[GC.PEOPLE_MAX_RESULTS],
                                sources=sources, mergeSources=mergeSources,
                                readMask=fields, fields='nextPageToken,people', **kwargs)
+  except GAPI.permissionDenied as e:
+    ClientAPIAccessDeniedExit(str(e))
   except (GAPI.serviceNotAvailable, GAPI.forbidden):
     ClientAPIAccessDeniedExit()
   if not countsOnly:
@@ -22638,6 +22622,8 @@ def printShowUserPeopleProfiles(users):
     except GAPI.notFound:
       entityUnknownWarning(Ent.PEOPLE_PROFILE, user, i, count)
       continue
+    except GAPI.permissionDenied as e:
+      ClientAPIAccessDeniedExit(str(e))
     except (GAPI.serviceNotAvailable, GAPI.forbidden):
       ClientAPIAccessDeniedExit()
     if not csvPF:
@@ -22792,6 +22778,8 @@ def _processPeopleContactPhotos(users, function):
         entityDoesNotHaveItemWarning([entityType, user, peopleEntityType, resourceName, Ent.PHOTO, filename], j, jcount)
       except (GAPI.invalidArgument, OSError, IOError) as e:
         entityActionFailedWarning([entityType, user, peopleEntityType, resourceName, Ent.PHOTO, filename], str(e), j, jcount)
+      except GAPI.permissionDenied as e:
+        ClientAPIAccessDeniedExit(str(e))
       except (GAPI.serviceNotAvailable, GAPI.forbidden):
         ClientAPIAccessDeniedExit()
         break
@@ -22866,7 +22854,7 @@ def createUserPeopleContactGroup(users):
         if addCSVData:
           row.update(addCSVData)
         csvPF.WriteRow(row)
-    except GAPI.forbidden:
+    except (GAPI.forbidden, GAPI.permissionDenied):
       userPeopleServiceNotEnabledWarning(user, i, count)
     except GAPI.serviceNotAvailable:
       entityUnknownWarning(entityType, user, i, count)
@@ -22920,7 +22908,7 @@ def updateUserPeopleContactGroup(users):
         entityActionPerformed([entityType, user, Ent.CONTACT_GROUP, contactGroup], j, jcount)
       except (GAPI.notFound, GAPI.internalError) as e:
         entityActionFailedWarning([entityType, user, Ent.CONTACT_GROUP, contactGroup], str(e), j, jcount)
-      except GAPI.forbidden:
+      except (GAPI.forbidden, GAPI.permissionDenied):
         userPeopleServiceNotEnabledWarning(user, i, count)
         break
       except GAPI.serviceNotAvailable:
@@ -22965,7 +22953,7 @@ def deleteUserPeopleContactGroups(users):
         entityActionPerformed([entityType, user, Ent.CONTACT_GROUP, contactGroup], j, jcount)
       except GAPI.notFound as e:
         entityActionFailedWarning([entityType, user, Ent.CONTACT_GROUP, contactGroup], str(e), j, jcount)
-      except GAPI.forbidden:
+      except (GAPI.forbidden, GAPI.permissionDenied):
         userPeopleServiceNotEnabledWarning(user, i, count)
         break
       except GAPI.serviceNotAvailable:
@@ -23066,7 +23054,7 @@ def infoUserPeopleContactGroups(users):
         _showContactGroup(entityType, user, Ent.CONTACT_GROUP, group, j, jcount, FJQC)
       except GAPI.notFound as e:
         entityActionFailedWarning([entityType, user, Ent.CONTACT_GROUP, contactGroup], str(e), j, jcount)
-      except GAPI.forbidden:
+      except (GAPI.forbidden, GAPI.permissionDenied):
         userPeopleServiceNotEnabledWarning(user, i, count)
         break
       except GAPI.serviceNotAvailable:
@@ -23115,6 +23103,8 @@ def printShowUserPeopleContactGroups(users):
                                  throwReasons=GAPI.PEOPLE_ACCESS_THROW_REASONS,
                                  pageSize=GC.Values[GC.PEOPLE_MAX_RESULTS],
                                  groupFields=fields, fields='nextPageToken,contactGroups')
+    except GAPI.permissionDenied as e:
+      ClientAPIAccessDeniedExit(str(e))
     except (GAPI.serviceNotAvailable, GAPI.forbidden):
       ClientAPIAccessDeniedExit()
     _printPersonEntityList(Ent.PEOPLE_CONTACT_GROUP, entityList, entityType, user, i, count, csvPF, FJQC, parameters, None)
@@ -24185,7 +24175,8 @@ def substituteQueryTimes(queries, queryTimes):
     for i, query in enumerate(queries):
       if query is not None:
         for queryTimeName, queryTimeValue in iter(queryTimes.items()):
-          queries[i] = query.replace(f'#{queryTimeName}#', queryTimeValue)
+          query = query.replace(f'#{queryTimeName}#', queryTimeValue)
+        queries[i] = query
 
 # Get CrOS devices from gam.cfg print_cros_ous and print_cros_ous_and_children
 def getCfgCrOSEntities():
@@ -34137,7 +34128,7 @@ def doPrintGroupMembers():
           for name in info['names']:
             if name['metadata']['source']['type'] == sourceType:
               return name['displayName']
-    except (GAPI.notFound, GAPI.serviceNotAvailable, GAPI.forbidden):
+    except (GAPI.notFound, GAPI.serviceNotAvailable, GAPI.forbidden, GAPI.permissionDenied):
       pass
     return unknownName
 
@@ -42266,776 +42257,26 @@ def doPrintVaultCounts():
     csvPF.WriteRow({'account': account, 'count': 0})
   csvPF.writeCSVfile('Vault Counts')
 
-def checkSiteExists(sitesObject, domain, site):
-  try:
-    callGData(sitesObject, 'GetSite',
-              throwErrors=[GDATA.NOT_FOUND],
-              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-              domain=domain, site=site)
-    return True
-  except GDATA.notFound:
-    return None
-
-SITE_ACLS = 'ACLs'
-SITE_CATEGORIES = 'Categories'
-SITE_LINK = 'Link'
-SITE_NAME = 'Name'
-SITE_SITE = 'Site'
-SITE_SOURCELINK = 'SourceLink'
-SITE_SUMMARY = 'Summary'
-SITE_THEME = 'Theme'
-SITE_UPDATED = 'Updated'
-SITE_WEB_ADDRESS_MAPPINGS = 'WebAddressMappings'
-
-SITE_DATA_DOMAIN = 'domain'
-SITE_DATA_SITE = 'site'
-SITE_DATA_DOMAIN_SITE = 'domainSite'
-SITE_DATA_FIELDS = 'fields'
-
-class SitesManager():
-
-  SITE_ARGUMENT_TO_PROPERTY_MAP = {
-    'categories': SITE_CATEGORIES,
-    'name': SITE_NAME,
-    'sourcelink': SITE_SOURCELINK,
-    'summary': SITE_SUMMARY,
-    'theme': SITE_THEME,
-    }
-
-  @staticmethod
-  def AclEntryToFields(acl_entry):
-
-    def GetAclAttr(attrlist):
-      objAttr = acl_entry
-      for attr in attrlist:
-        objAttr = getattr(objAttr, attr)
-        if not objAttr:
-          return None
-      return objAttr
-
-    fields = {}
-    fields['role'] = GetAclAttr(['role', 'value'])
-    if not fields['role']:
-      fields['role'] = GetAclAttr(['withKey', 'role', 'value'])+' (with link)'
-    fields['scope'] = {'type': GetAclAttr(['scope', 'type']),
-                       'value': GetAclAttr(['scope', 'value'])}
-    link = acl_entry.FindInviteLink()
-    if link:
-      fields['inviteLink'] = link
-    return fields
-
-  @staticmethod
-  def FieldsToAclEntry(fields):
-    acl_entry = gdata.apps.sites.AclEntry()
-    acl_entry.role = gdata.apps.sites.AclRole(value=fields['role'])
-    acl_entry.scope = gdata.apps.sites.AclScope(stype=fields['scope']['type'], value=fields['scope'].get('value'))
-    return acl_entry
-
-  @staticmethod
-  def ActivityEntryToFields(activity_entry):
-    fields = {}
-
-    def GetActivityField(fieldName, attrlist):
-      objAttr = activity_entry
-      for attr in attrlist:
-        objAttr = getattr(objAttr, attr)
-        if not objAttr:
-          return
-      fields[fieldName] = objAttr
-
-    def GetActivityFieldData(objAttr, attrlist, default):
-      for attr in attrlist:
-        objAttr = getattr(objAttr, attr)
-        if not objAttr:
-          return default
-      return  objAttr
-
-    def AppendItemToFieldsList(fieldName, fieldValue):
-      fields.setdefault(fieldName, [])
-      fields[fieldName].append(fieldValue)
-
-    GetActivityField('Summary', ['title', 'text'])
-    GetActivityField('Updated', ['updated', 'text'])
-    for author in activity_entry.author:
-      AppendItemToFieldsList('Authors', f'{GetActivityFieldData(author, ["name", "text"], "Unknown Name")}/{GetActivityFieldData(author, ["email", "text"], "Unknown Email")}')
-    fields['Operation'] = activity_entry.Kind()
-    return fields
-
-  @staticmethod
-  def SiteToFields(site_entry):
-    fields = {}
-
-    def GetSiteField(fieldName, attrlist):
-      objAttr = site_entry
-      for attr in attrlist:
-        objAttr = getattr(objAttr, attr)
-        if not objAttr:
-          return
-      fields[fieldName] = objAttr
-
-    def AppendItemToFieldsList(fieldName, fieldValue):
-      fields.setdefault(fieldName, [])
-      fields[fieldName].append(fieldValue)
-
-    GetSiteField(SITE_SITE, ['siteName', 'text'])
-    GetSiteField(SITE_NAME, ['title', 'text'])
-    GetSiteField(SITE_SUMMARY, ['summary', 'text'])
-    GetSiteField(SITE_THEME, ['theme', 'text'])
-    GetSiteField(SITE_UPDATED, ['updated', 'text'])
-    if site_entry.category:
-      for category in site_entry.category:
-        if category.term:
-          AppendItemToFieldsList(SITE_CATEGORIES, category.term)
-    link = site_entry.FindAlternateLink()
-    if link:
-      fields[SITE_LINK] = link
-    link = site_entry.FindSourceLink()
-    if link:
-      fields[SITE_SOURCELINK] = link
-    for link in site_entry.FindWebAddressMappings():
-      AppendItemToFieldsList(SITE_WEB_ADDRESS_MAPPINGS, link)
-    return fields
-
-  @staticmethod
-  def GetSiteFields():
-
-    fields = {}
-    while Cmd.ArgumentsRemaining():
-      myarg = getArgument()
-      if myarg in SitesManager.SITE_ARGUMENT_TO_PROPERTY_MAP:
-        fieldName = SitesManager.SITE_ARGUMENT_TO_PROPERTY_MAP[myarg]
-        if fieldName == SITE_NAME:
-          fields[fieldName] = getString(Cmd.OB_STRING)
-        elif fieldName == SITE_SOURCELINK:
-          fields[fieldName] = getString(Cmd.OB_URI)
-        elif fieldName == SITE_SUMMARY:
-          fields[fieldName] = getStringWithCRsNLs()
-        elif fieldName == SITE_THEME:
-          fields[fieldName] = getString(Cmd.OB_STRING)
-        elif fieldName == SITE_CATEGORIES:
-          fields[fieldName] = getString(Cmd.OB_STRING, minLen=0).split(',')
-      else:
-        unknownArgumentExit()
-    return fields
-
-  @staticmethod
-  def FieldsToSite(fields):
-    def GetField(fieldName):
-      return fields.get(fieldName)
-
-    def GetSiteField(fieldName, fieldClass):
-      value = fields.get(fieldName)
-      if value:
-        return fieldClass(text=value)
-      return None
-
-    site_entry = gdata.apps.sites.SiteEntry(sourceSite=GetField(SITE_SOURCELINK))
-    site_entry.siteName = GetSiteField(SITE_SITE, gdata.apps.sites.SiteName)
-    site_entry.title = GetSiteField(SITE_NAME, atom.Title)
-    site_entry.summary = GetSiteField(SITE_SUMMARY, atom.Summary)
-    site_entry.theme = GetSiteField(SITE_THEME, gdata.apps.sites.Theme)
-    value = GetField(SITE_CATEGORIES)
-    if value:
-      for category in value:
-        site_entry.category.append(atom.Category(term=category, scheme=gdata.apps.sites.TAG_KIND_TERM))
-    return site_entry
-
-def getSiteEntity():
-  siteEntity = {'list': getEntityList(Cmd.OB_SITE_ENTITY), 'dict': None}
-  if isinstance(siteEntity['list'], dict):
-    siteEntity['dict'] = siteEntity['list']
-  return siteEntity
-
-def _validateUserGetSites(entityType, user, i, count, siteEntity, itemType=None, modifier=None):
-  if siteEntity['dict']:
-    sites = siteEntity['dict'][user]
-  else:
-    sites = siteEntity['list']
-  user, sitesObject = getSitesObject(entityType, user, i, count)
-  if not sitesObject:
-    return (user, None, None, 0)
-  jcount = len(sites)
-  if not itemType:
-    entityPerformActionNumItems([entityType, user], jcount, Ent.SITE, i, count)
-  else:
-    entityPerformActionSubItemModifierNumItems([entityType, user], itemType, modifier, jcount, Ent.SITE, i, count)
-  if jcount == 0:
-    setSysExitRC(NO_ENTITIES_FOUND_RC)
-  return (user, sitesObject, sites, jcount)
-
-def _validateSite(fullSite, i, count):
-  domain, site, domainSite = validateSplitSiteName(fullSite)
-  if domainSite:
-    return (domain, site, domainSite)
-  entityActionNotPerformedWarning([Ent.SITE, site], Msg.INVALID_SITE.format(site, SITENAME_FORMAT_REQUIRED), i, count)
-  return (domain, site, None)
-
-def _validateSiteGetRuleIds(origUser, fullSite, j, jcount, ACLScopeEntity, showAction=True):
-  domain, site, domainSite = _validateSite(fullSite, j, jcount)
-  if not domainSite:
-    return (domain, site, None, None, 0)
-  if ACLScopeEntity:
-    if ACLScopeEntity['dict']:
-      if not GM.Globals[GM.CSV_SUBKEY_FIELD]:
-        ruleIds = ACLScopeEntity['dict'][fullSite]
-      else:
-        ruleIds = ACLScopeEntity['dict'][origUser][fullSite]
-    else:
-      ruleIds = ACLScopeEntity['list']
-    kcount = len(ruleIds)
-    if kcount == 0:
-      setSysExitRC(NO_ENTITIES_FOUND_RC)
-  else:
-    ruleIds = []
-    kcount = 0
-  if showAction:
-    entityPerformActionNumItems([Ent.SITE, domainSite], kcount, Ent.SITE_ACL, j, jcount)
-  return (domain, site, domainSite, ruleIds, kcount)
-
-def _createSite(users, entityType):
-  sitesManager = SitesManager()
-  domain, site, domainSite = getSiteName()
-  fields = sitesManager.GetSiteFields()
-  if not fields.get(SITE_NAME):
-    fields[SITE_NAME] = site
-  i, count, users = getEntityArgument(users)
-  for user in users:
-    i += 1
-    user, sitesObject = getSitesObject(entityType, user, i, count)
-    if not sitesObject:
-      continue
-    try:
-      siteEntry = sitesManager.FieldsToSite(fields)
-      callGData(sitesObject, 'CreateSite',
-                throwErrors=[GDATA.NOT_FOUND, GDATA.ENTITY_EXISTS, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                siteentry=siteEntry, domain=domain, site=None)
-      entityActionPerformed([Ent.SITE, domainSite])
-    except GDATA.notFound as e:
-      entityActionFailedWarning([Ent.DOMAIN, domain], str(e))
-    except (GDATA.entityExists, GDATA.badRequest, GDATA.forbidden) as e:
-      entityActionFailedWarning([Ent.SITE, domainSite], str(e))
-
 # gam [<UserTypeEntity>] create site <SiteName> <SiteAttribute>*
-def createUserSite(users):
-  _createSite(users, Ent.USER)
-
-def doCreateDomainSite():
-  _createSite([GC.Values[GC.DOMAIN]], Ent.DOMAIN)
-
-def _updateSites(users, entityType):
-  sitesManager = SitesManager()
-  siteEntity = getSiteEntity()
-  updateFields = sitesManager.GetSiteFields()
-  i, count, users = getEntityArgument(users)
-  for user in users:
-    i += 1
-    user, sitesObject, sites, jcount = _validateUserGetSites(entityType, user, i, count, siteEntity)
-    if jcount == 0:
-      continue
-    Ind.Increment()
-    j = 0
-    for site in sites:
-      j += 1
-      domain, site, domainSite = _validateSite(site, j, jcount)
-      if not domainSite:
-        continue
-      try:
-        siteEntry = callGData(sitesObject, 'GetSite',
-                              throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                              domain=domain, site=site)
-        fields = sitesManager.SiteToFields(siteEntry)
-        for field, value in iter(updateFields.items()):
-          if field != SITE_SOURCELINK:
-            fields[field] = value
-        newSiteEntry = sitesManager.FieldsToSite(fields)
-        callGData(sitesObject, 'UpdateSite',
-                  throwErrors=[GDATA.NOT_FOUND, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                  retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                  siteentry=newSiteEntry, domain=domain, site=site, extra_headers={'If-Match': siteEntry.etag})
-        entityActionPerformed([Ent.SITE, domainSite])
-      except (GDATA.notFound, GDATA.badRequest, GDATA.forbidden) as e:
-        entityActionFailedWarning([Ent.SITE, domainSite], str(e))
-
 # gam [<UserTypeEntity>] update site <SiteEntity> <SiteAttribute>+
-def updateUserSites(users):
-  _updateSites(users, Ent.USER)
-
-def doUpdateDomainSites():
-  _updateSites([GC.Values[GC.DOMAIN]], Ent.DOMAIN)
-
-SITE_FIELD_PRINT_ORDER = [
-  SITE_UPDATED,
-  SITE_NAME,
-  SITE_SUMMARY,
-  SITE_THEME,
-  SITE_SOURCELINK,
-  SITE_CATEGORIES,
-  SITE_LINK,
-  ]
-
-def _showSite(sitesManager, sitesObject, domain, site, roles, j, jcount):
-  fields = sitesManager.SiteToFields(site)
-  domainSite = f'{domain}/{fields[SITE_SITE]}'
-  printKeyValueListWithCount([SITE_SITE, domainSite], j, jcount)
-  Ind.Increment()
-  for field in SITE_FIELD_PRINT_ORDER:
-    if field in fields:
-      if not isinstance(fields[field], list):
-        if field != SITE_SUMMARY:
-          printKeyValueList([field, fields[field]])
-        else:
-          printKeyValueWithCRsNLs(field, fields[field])
-      else:
-        printKeyValueList([field, ','.join(fields[field])])
-  if fields.get(SITE_WEB_ADDRESS_MAPPINGS):
-    printKeyValueList([SITE_WEB_ADDRESS_MAPPINGS, None])
-    Ind.Increment()
-    for link in fields[SITE_WEB_ADDRESS_MAPPINGS]:
-      printKeyValueList([link, None])
-    Ind.Decrement()
-  if roles:
-    try:
-      acls = callGDataPages(sitesObject, 'GetAclFeed',
-                            throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                            retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                            domain=domain, site=fields[SITE_SITE])
-      printKeyValueList([SITE_ACLS, None])
-      Ind.Increment()
-      for acl in acls:
-        fields = sitesManager.AclEntryToFields(acl)
-        if fields['role'] in roles:
-          printKeyValueList([formatACLRule(fields)])
-      Ind.Decrement()
-    except GDATA.notFound as e:
-      entityActionFailedWarning([Ent.SITE, domainSite], str(e))
-    except GDATA.forbidden:
-      pass
-  Ind.Decrement()
-
-SITE_ACL_ROLES_MAP = {
-  'editor': 'writer',
-  'invite': 'invite',
-  'owner': 'owner',
-  'read': 'reader',
-  'reader': 'reader',
-  'writer': 'writer',
-  }
-
-def _infoSites(users, entityType):
-  siteEntity = getSiteEntity()
-  url_params = {}
-  roles = set()
-  while Cmd.ArgumentsRemaining():
-    myarg = getArgument()
-    if myarg == 'withmappings':
-      url_params['with-mappings'] = 'true'
-    elif myarg in {'role', 'roles'}:
-      roles = getACLRoles(SITE_ACL_ROLES_MAP)
-    else:
-      unknownArgumentExit()
-  sitesManager = SitesManager()
-  i, count, users = getEntityArgument(users)
-  for user in users:
-    i += 1
-    user, sitesObject, sites, jcount = _validateUserGetSites(entityType, user, i, count, siteEntity)
-    if jcount == 0:
-      continue
-    Ind.Increment()
-    j = 0
-    for site in sites:
-      j += 1
-      domain, site, domainSite = _validateSite(site, j, jcount)
-      if not domainSite:
-        continue
-      try:
-        result = callGData(sitesObject, 'GetSite',
-                           throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                           retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                           domain=domain, site=site, url_params=url_params)
-        if result:
-          _showSite(sitesManager, sitesObject, domain, result, roles, j, jcount)
-      except (GDATA.notFound, GDATA.forbidden) as e:
-        entityActionFailedWarning([Ent.SITE, domainSite], str(e))
-    Ind.Decrement()
-
 # gam [<UserTypeEntity>] info site <SiteEntity> [withmappings] [role|roles all|<SiteACLRoleList>]
-def infoUserSites(users):
-  _infoSites(users, Ent.USER)
-
-def doInfoDomainSites():
-  _infoSites([GC.Values[GC.DOMAIN]], Ent.DOMAIN)
-
-def printShowSites(entityList, entityType):
-  def _getSites(domain, i, count):
-    try:
-      return callGDataPages(sitesObject, 'GetSiteFeed',
-                            pageMessage=getPageMessageForWhom(),
-                            throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                            retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                            domain=domain, url_params=url_params)
-    except (GDATA.notFound, GDATA.forbidden) as e:
-      entityActionFailedWarning([Ent.DOMAIN, domain], str(e), i, count)
-    return []
-
-  def _printSites(entity, i, count, domain, sites):
-    for site in sites:
-      fields = sitesManager.SiteToFields(site)
-      if fields[SITE_SITE] in sitesSet:
-        continue
-      sitesSet.add(fields[SITE_SITE])
-      domainSite = f'{domain}/{fields[SITE_SITE]}'
-      siteRow = {Ent.Singular(entityType): entity, SITE_SITE: domainSite}
-      for field, value in iter(fields.items()):
-        if field != SITE_SITE:
-          if not isinstance(value, list):
-            if field != SITE_SUMMARY or not convertCRNL:
-              siteRow[field] = value
-            else:
-              siteRow[field] = escapeCRsNLs(value)
-          else:
-            siteRow[field] = delimiter.join(value)
-      rowShown = False
-      if roles:
-        try:
-          acls = callGDataPages(sitesObject, 'GetAclFeed',
-                                throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                                retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                                domain=domain, site=fields[SITE_SITE])
-          for acl in acls:
-            fields = sitesManager.AclEntryToFields(acl)
-            if fields['role'] in roles:
-              siteACLRow = siteRow.copy()
-              siteACLRow.update(ACLRuleDict(fields))
-              csvPF.WriteRowTitles(siteACLRow)
-              rowShown = True
-        except GDATA.notFound as e:
-          entityActionFailedWarning([Ent.SITE, domainSite], str(e), i, count)
-        except GDATA.forbidden:
-          pass
-      if not rowShown:
-        csvPF.WriteRowTitles(siteRow)
-
-  def _showSites(entity, i, count, domain, sites):
-    jcount = len(sites)
-    if entityType == Ent.USER:
-      entityPerformActionNumItems([entityType, entity, Ent.DOMAIN, domain], jcount, Ent.SITE, i, count)
-    else:
-      entityPerformActionNumItems([entityType, entity], jcount, Ent.SITE, i, count)
-    Ind.Increment()
-    j = 0
-    for site in sites:
-      j += 1
-      _showSite(sitesManager, sitesObject, domain, site, roles, j, jcount)
-    Ind.Decrement()
-
-  domains = []
-  domainLists = []
-  url_params = {}
-  includeAllSites = 'true' if entityType == Ent.DOMAIN else 'false'
-  roles = set()
-  convertCRNL = GC.Values[GC.CSV_OUTPUT_CONVERT_CR_NL]
-  delimiter = GC.Values[GC.CSV_OUTPUT_FIELD_DELIMITER]
-  csvPF = CSVPrintFile([Ent.Singular(entityType), SITE_SITE, SITE_NAME, SITE_SUMMARY], 'sortall') if Act.csvFormat() else None
-  while Cmd.ArgumentsRemaining():
-    myarg = getArgument()
-    if csvPF and myarg == 'todrive':
-      csvPF.GetTodriveParameters()
-    elif myarg in {'domain', 'domains'}:
-      if entityType == Ent.DOMAIN:
-        entityList = getEntityList(Cmd.OB_DOMAIN_NAME_ENTITY)
-      else:
-        domains = getEntityList(Cmd.OB_DOMAIN_NAME_ENTITY)
-        domainLists = domains if isinstance(domains, dict) else None
-    elif myarg == 'includeallsites':
-      includeAllSites = 'true'
-    elif myarg == 'maxresults':
-      url_params['max-results'] = getInteger(minVal=1)
-    elif myarg == 'startindex':
-      url_params['start-index'] = getInteger(minVal=1)
-    elif myarg == 'withmappings':
-      url_params['with-mappings'] = 'true'
-    elif myarg in {'role', 'roles'}:
-      roles = getACLRoles(SITE_ACL_ROLES_MAP)
-    elif myarg in {'convertcrnl', 'converttextnl', 'convertsummarynl'}:
-      convertCRNL = True
-    elif myarg == 'delimiter':
-      delimiter = getCharacter()
-    else:
-      unknownArgumentExit()
-  sitesManager = SitesManager()
-  sitesSet = set()
-  i, count, entityList = getEntityArgument(entityList)
-  if entityType == Ent.USER:
-    for user in entityList:
-      i += 1
-      if domainLists:
-        domainList = domainLists[user]
-      elif domains:
-        domainList = domains
-      else:
-        _, domain = splitEmailAddress(user)
-        domainList = [domain]
-      user, sitesObject = getSitesObject(entityType, user, i, count)
-      if not sitesObject:
-        continue
-      jcount = len(domainList)
-      j = 0
-      for domain in domainList:
-        j += 1
-        if domain != 'site':
-          url_params['include-all-sites'] = includeAllSites
-        else:
-          url_params.pop('include-all-sites', None)
-        printGettingAllEntityItemsForWhom(Ent.SITE, f'{Ent.Singular(Ent.USER)}: {user}, {Ent.Singular(Ent.DOMAIN)}: {domain}')
-        sites = _getSites(domain, i, count)
-        if not csvPF:
-          _showSites(domain, j, jcount, domain, sites)
-        else:
-          _printSites(user, j, jcount, domain, sites)
-  else:
-    for domain in entityList:
-      i += 1
-      domain, sitesObject = getSitesObject(entityType, domain, i, count)
-      if not sitesObject:
-        continue
-      if domain != 'site':
-        url_params['include-all-sites'] = includeAllSites
-      else:
-        url_params.pop('include-all-sites', None)
-      printGettingAllEntityItemsForWhom(Ent.SITE, f'{Ent.Singular(Ent.DOMAIN)}: {domain}')
-      sites = _getSites(domain, i, count)
-      if not csvPF:
-        _showSites(domain, i, count, domain, sites)
-      else:
-        _printSites(domain, i, count, domain, sites)
-  if csvPF:
-    csvPF.SortTitles()
-    csvPF.SetSortTitles([])
-    if roles:
-      csvPF.MoveTitlesToEnd(['Scope', 'Role'])
-    csvPF.writeCSVfile('Sites')
-
-# gam print sites [todrive <ToDriveAttribute>*] [domain|domains <DomainNameEntity>] [includeallsites]
-#	[withmappings] [role|roles all|<SiteACLRoleList>] [startindex <Number>] [maxresults <Number>] [convertcrnl] [delimiter <Character>]
-# gam show sites [domain|domains <DomainNameEntity>] [includeallsites]
-#	[withmappings] [role|roles all|<SiteACLRoleList>] [startindex <Number>] [maxresults <Number>] [convertcrnl]
-def doPrintShowDomainSites():
-  printShowSites([GC.Values[GC.DOMAIN]], Ent.DOMAIN)
-
 # gam [<UserTypeEntity>] print sites [todrive <ToDriveAttribute>*] [domain|domains <DomainNameEntity>] [includeallsites]
 #	[withmappings] [role|roles all|<SiteACLRoleList>] [startindex <Number>] [maxresults <Number>] [convertcrnl] [delimiter <Character>]
 # gam [<UserTypeEntity>] show sites [domain|domains <DomainNameEntity>] [includeallsites]
 #	[withmappings] [role|roles all|<SiteACLRoleList>] [startindex <Number>] [maxresults <Number>] [convertcrnl]
-def printShowUserSites(users):
-  printShowSites(users, Ent.USER)
-
-SITE_ACTION_TO_MODIFIER_MAP = {
-  Act.ADD: Act.MODIFIER_TO,
-  Act.UPDATE: Act.MODIFIER_IN,
-  Act.DELETE: Act.MODIFIER_FROM,
-  Act.INFO: Act.MODIFIER_FROM,
-  Act.PRINT: Act.MODIFIER_FROM,
-  Act.SHOW: Act.MODIFIER_FROM,
-  }
-
-def _processSiteACLs(users, entityType):
-  action = Act.Get()
-  siteEntity = getSiteEntity()
-  csvPF = None
-  if action in [Act.ADD, Act.UPDATE]:
-    role = getChoice(SITE_ACL_ROLES_MAP, mapChoice=True)
-  elif action == Act.PRINT:
-    csvPF = CSVPrintFile([Ent.Singular(entityType), SITE_SITE, 'Scope', 'Role'])
-  else:
-    role = None
-  actionPrintShow = action in [Act.PRINT, Act.SHOW]
-  ACLScopeEntity = getCalendarSiteACLScopeEntity() if not actionPrintShow else {}
-  getTodriveOnly(csvPF)
-  modifier = SITE_ACTION_TO_MODIFIER_MAP[action]
-  sitesManager = SitesManager()
-  i, count, users = getEntityArgument(users)
-  for user in users:
-    i += 1
-    origUser = user
-    user, sitesObject, sites, jcount = _validateUserGetSites(entityType, user, i, count, siteEntity, Ent.SITE_ACL, modifier)
-    if jcount == 0:
-      continue
-    Ind.Increment()
-    j = 0
-    for site in sites:
-      j += 1
-      domain, site, domainSite, ruleIds, kcount = _validateSiteGetRuleIds(origUser, site, j, jcount, ACLScopeEntity, showAction=not actionPrintShow)
-      if not domainSite:
-        continue
-      if not actionPrintShow:
-        Ind.Increment()
-        k = 0
-        for ruleId in ruleIds:
-          k += 1
-          ruleId = normalizeRuleId(ruleId)
-          try:
-            if action in [Act.CREATE, Act.ADD]:
-              acl = callGData(sitesObject, 'CreateAclEntry',
-                              throwErrors=[GDATA.NOT_FOUND, GDATA.ENTITY_EXISTS, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                              aclentry=sitesManager.FieldsToAclEntry(makeRoleRuleIdBody(role, ruleId)), domain=domain, site=site)
-              fields = sitesManager.AclEntryToFields(acl)
-              if not fields.get('inviteLink'):
-                entityActionPerformed([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLRule(fields)], k, kcount)
-              else:
-                entityActionPerformed([Ent.SITE, domainSite, Ent.SITE_ACL, f'{formatACLRule(fields)} (Link: {fields["inviteLink"]})'], k, kcount)
-            elif action == Act.UPDATE:
-              acl = callGData(sitesObject, 'GetAclEntry',
-                              throwErrors=[GDATA.NOT_FOUND, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                              domain=domain, site=site, ruleId=ruleId)
-              acl.role.value = role
-              acl = callGData(sitesObject, 'UpdateAclEntry',
-                              throwErrors=[GDATA.NOT_FOUND, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                              aclentry=acl, domain=domain, site=site, ruleId=ruleId, extra_headers={'If-Match': acl.etag})
-              fields = sitesManager.AclEntryToFields(acl)
-              entityActionPerformed([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLRule(fields)], k, kcount)
-            elif action == Act.DELETE:
-              acl = callGData(sitesObject, 'GetAclEntry',
-                              throwErrors=[GDATA.NOT_FOUND, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                              domain=domain, site=site, ruleId=ruleId)
-              callGData(sitesObject, 'DeleteAclEntry',
-                        throwErrors=[GDATA.NOT_FOUND, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                        retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                        domain=domain, site=site, ruleId=ruleId, extra_headers={'If-Match': acl.etag})
-              entityActionPerformed([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLScopeRole(ruleId, None)], k, kcount)
-            elif action == Act.INFO:
-              acl = callGData(sitesObject, 'GetAclEntry',
-                              throwErrors=[GDATA.NOT_FOUND, GDATA.BAD_REQUEST, GDATA.FORBIDDEN],
-                              retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                              domain=domain, site=site, ruleId=ruleId)
-              fields = sitesManager.AclEntryToFields(acl)
-              printEntity([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLRule(fields)], k, kcount)
-          except GDATA.notFound as e:
-            if not checkSiteExists(sitesObject, domain, site):
-              entityUnknownWarning(Ent.SITE, domainSite, j, jcount)
-              break
-            entityActionFailedWarning([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLScopeRole(ruleId, role)], str(e), k, kcount)
-          except (GDATA.entityExists, GDATA.badRequest, GDATA.forbidden) as e:
-            entityActionFailedWarning([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLScopeRole(ruleId, role)], str(e), k, kcount)
-        Ind.Decrement()
-      else:
-        try:
-          acls = callGDataPages(sitesObject, 'GetAclFeed',
-                                throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                                retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                                domain=domain, site=site)
-          if not csvPF:
-            kcount = len(acls)
-            entityPerformActionNumItems([Ent.SITE, domainSite], kcount, Ent.SITE_ACL, j, jcount)
-            if kcount == 0:
-              continue
-            Ind.Increment()
-            k = 0
-            for acl in acls:
-              k += 1
-              fields = sitesManager.AclEntryToFields(acl)
-              printEntity([Ent.SITE, domainSite, Ent.SITE_ACL, formatACLRule(fields)], k, kcount)
-            Ind.Decrement()
-          else:
-            siteRow = {Ent.Singular(entityType): user, SITE_SITE: domainSite}
-            for acl in acls:
-              fields = sitesManager.AclEntryToFields(acl)
-              siteACLRow = siteRow.copy()
-              siteACLRow.update(ACLRuleDict(fields))
-              csvPF.WriteRowTitles(siteACLRow)
-        except GDATA.notFound:
-          entityUnknownWarning(Ent.SITE, domainSite, j, jcount)
-        except GDATA.forbidden as e:
-          entityActionFailedWarning([Ent.SITE, domainSite], str(e), j, jcount)
-    Ind.Decrement()
-  if csvPF:
-    csvPF.writeCSVfile('Site ACLs')
-
 # gam [<UserTypeEntity>] create siteacls <SiteEntity> <SiteACLRole> <SiteACLScopeEntity>
 # gam [<UserTypeEntity>] update siteacls <SiteEntity> <SiteACLRole> <SiteACLScopeEntity>
 # gam [<UserTypeEntity>] delete siteacls <SiteEntity> <SiteACLScopeEntity>
 # gam [<UserTypeEntity>] info siteacls <SiteEntity> <SiteACLScopeEntity>
 # gam [<UserTypeEntity>] show siteacls <SiteEntity>
 # gam [<UserTypeEntity>] print siteacls <SiteEntity> [todrive <ToDriveAttribute>*]
-def processUserSiteACLs(users):
-  _processSiteACLs(users, Ent.USER)
-
-def doProcessDomainSiteACLs():
-  _processSiteACLs([GC.Values[GC.DOMAIN]], Ent.DOMAIN)
-
-def _printSiteActivity(users, entityType):
-  sitesManager = SitesManager()
-  url_params = {}
-  csvPF = CSVPrintFile([SITE_SITE, SITE_SUMMARY, SITE_UPDATED], 'sortall')
-  sites = getEntityList(Cmd.OB_SITE_ENTITY)
-  siteLists = sites if isinstance(sites, dict) else None
-  while Cmd.ArgumentsRemaining():
-    myarg = getArgument()
-    if myarg == 'todrive':
-      csvPF.GetTodriveParameters()
-    elif myarg == 'maxresults':
-      url_params['max-results'] = getInteger(minVal=1)
-    elif myarg == 'startindex':
-      url_params['start-index'] = getInteger(minVal=1)
-    elif myarg == 'updatedmin':
-      url_params['updated-min'] = getYYYYMMDD()
-    elif myarg == 'updatedmax':
-      url_params['updated-max'] = getYYYYMMDD()
-    else:
-      unknownArgumentExit()
-  i, count, users = getEntityArgument(users)
-  for user in users:
-    i += 1
-    if siteLists:
-      sites = siteLists[user]
-    user, sitesObject = getSitesObject(entityType, user, i, count)
-    if not sitesObject:
-      continue
-    jcount = len(sites)
-    if jcount == 0:
-      setSysExitRC(NO_ENTITIES_FOUND_RC)
-      continue
-    Ind.Increment()
-    j = 0
-    for site in sites:
-      j += 1
-      domain, site, domainSite = _validateSite(site, j, jcount)
-      if not domainSite:
-        continue
-      printGettingAllEntityItemsForWhom(Ent.ACTIVITY, domainSite)
-      try:
-        activities = callGDataPages(sitesObject, 'GetActivityFeed',
-                                    pageMessage=getPageMessageForWhom(),
-                                    throwErrors=[GDATA.NOT_FOUND, GDATA.FORBIDDEN],
-                                    retryErrors=[GDATA.INTERNAL_SERVER_ERROR],
-                                    domain=domain, site=site, url_params=url_params)
-        for activity in activities:
-          fields = sitesManager.ActivityEntryToFields(activity)
-          activityRow = {SITE_SITE: domainSite}
-          for key, value in iter(fields.items()):
-            if not isinstance(value, list):
-              activityRow[key] = value
-            else:
-              activityRow[key] = ','.join(value)
-          csvPF.WriteRowTitles(activityRow)
-      except GDATA.notFound:
-        entityUnknownWarning(Ent.SITE, domainSite, j, jcount)
-      except GDATA.forbidden as e:
-        entityActionFailedWarning([Ent.SITE, domainSite], str(e), j, jcount)
-  csvPF.writeCSVfile('Site Activities')
-
 # gam [<UserTypeEntity>] print siteactivity <SiteEntity> [todrive <ToDriveAttribute>*]
 #	[startindex <Number>] [maxresults <Number>] [updated_min <Date>] [updated_max <Date>]
-def printUserSiteActivity(users):
-  _printSiteActivity(users, Ent.USER)
+def deprecatedUserSites(users):
+  deprecatedCommandExit()
 
-def doPrintDomainSiteActivity():
-  _printSiteActivity([GC.Values[GC.DOMAIN]], Ent.DOMAIN)
+def deprecatedDomainSites():
+  deprecatedCommandExit()
 
 # <CSVFileInput> [keyfield <FieldName>] [datafield <FieldName>]
 def _getGroupOrgUnitMap():
@@ -75733,8 +74974,8 @@ MAIN_ADD_CREATE_FUNCTIONS = {
   Cmd.ARG_SAKEY:		doCreateSvcAcctKeys,
   Cmd.ARG_SCHEMA:		doCreateUpdateUserSchemas,
   Cmd.ARG_SHAREDDRIVE:		doCreateSharedDrive,
-  Cmd.ARG_SITE:			doCreateDomainSite,
-  Cmd.ARG_SITEACL:		doProcessDomainSiteACLs,
+  Cmd.ARG_SITE:			deprecatedDomainSites,
+  Cmd.ARG_SITEACL:		deprecatedDomainSites,
   Cmd.ARG_SVCACCT:		doCreateSvcAcct,
   Cmd.ARG_USER:			doCreateUser,
   Cmd.ARG_VAULTEXPORT:		doCreateVaultExport,
@@ -75848,7 +75089,7 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SAKEY:		doDeleteSvcAcctKeys,
       Cmd.ARG_SCHEMA:		doDeleteUserSchemas,
       Cmd.ARG_SHAREDDRIVE:	doDeleteSharedDrive,
-      Cmd.ARG_SITEACL:		doProcessDomainSiteACLs,
+      Cmd.ARG_SITEACL:		deprecatedDomainSites,
       Cmd.ARG_SVCACCT:		doDeleteSvcAcct,
       Cmd.ARG_USER:		doDeleteUser,
       Cmd.ARG_USERS:		doDeleteUsers,
@@ -75937,8 +75178,8 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_RESOURCES:	doInfoResourceCalendars,
       Cmd.ARG_SCHEMA:		doInfoUserSchemas,
       Cmd.ARG_SHAREDDRIVE:	doInfoSharedDrive,
-      Cmd.ARG_SITE:		doInfoDomainSites,
-      Cmd.ARG_SITEACL:		doProcessDomainSiteACLs,
+      Cmd.ARG_SITE:		deprecatedDomainSites,
+      Cmd.ARG_SITEACL:		deprecatedDomainSites,
       Cmd.ARG_USER:		doInfoUser,
       Cmd.ARG_USERS:		doInfoUsers,
       Cmd.ARG_USERINVITATION:	doInfoCIUserInvitations,
@@ -76040,9 +75281,9 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SCHEMA:		doPrintShowUserSchemas,
       Cmd.ARG_SHAREDDRIVE:	doPrintShowSharedDrives,
       Cmd.ARG_SHAREDDRIVEACLS:	doPrintShowSharedDriveACLs,
-      Cmd.ARG_SITE:		doPrintShowDomainSites,
-      Cmd.ARG_SITEACL:		doProcessDomainSiteACLs,
-      Cmd.ARG_SITEACTIVITY:	doPrintDomainSiteActivity,
+      Cmd.ARG_SITE:		deprecatedDomainSites,
+      Cmd.ARG_SITEACL:		deprecatedDomainSites,
+      Cmd.ARG_SITEACTIVITY:	deprecatedDomainSites,
       Cmd.ARG_SVCACCT:		doPrintShowSvcAccts,
       Cmd.ARG_TOKEN:		doPrintShowTokens,
       Cmd.ARG_TRANSFERAPPS:	doShowTransferApps,
@@ -76158,8 +75399,8 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SHAREDDRIVEACLS:	doPrintShowSharedDriveACLs,
       Cmd.ARG_SHAREDDRIVEINFO:	doInfoSharedDrive,
       Cmd.ARG_SHAREDDRIVETHEMES:	doShowSharedDriveThemes,
-      Cmd.ARG_SITE:		doPrintShowDomainSites,
-      Cmd.ARG_SITEACL:		doProcessDomainSiteACLs,
+      Cmd.ARG_SITE:		deprecatedDomainSites,
+      Cmd.ARG_SITEACL:		deprecatedDomainSites,
       Cmd.ARG_SVCACCT:		doPrintShowSvcAccts,
       Cmd.ARG_TOKEN:		doPrintShowTokens,
       Cmd.ARG_TRANSFERAPPS:	doShowTransferApps,
@@ -76224,8 +75465,8 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SAKEY:		doUpdateSvcAcctKeys,
       Cmd.ARG_SCHEMA:		doCreateUpdateUserSchemas,
       Cmd.ARG_SHAREDDRIVE:	doUpdateSharedDrive,
-      Cmd.ARG_SITE:		doUpdateDomainSites,
-      Cmd.ARG_SITEACL:		doProcessDomainSiteACLs,
+      Cmd.ARG_SITE:		deprecatedDomainSites,
+      Cmd.ARG_SITEACL:		deprecatedDomainSites,
       Cmd.ARG_SVCACCT:		doCheckUpdateSvcAcct,
       Cmd.ARG_USER:		doUpdateUser,
       Cmd.ARG_USERS:		doUpdateUsers,
@@ -76764,8 +76005,8 @@ USER_ADD_CREATE_FUNCTIONS = {
   Cmd.ARG_SENDAS:		createUpdateSendAs,
   Cmd.ARG_SHAREDDRIVE:		createSharedDrive,
   Cmd.ARG_SHEET:		createSheet,
-  Cmd.ARG_SITE:			createUserSite,
-  Cmd.ARG_SITEACL:		processUserSiteACLs,
+  Cmd.ARG_SITE:			deprecatedUserSites,
+  Cmd.ARG_SITEACL:		deprecatedUserSites,
   Cmd.ARG_SMIME:		createSmime,
   Cmd.ARG_TASK:			processTasks,
   Cmd.ARG_TASKLIST:		processTasklists,
@@ -76883,7 +76124,7 @@ USER_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SENDAS:		deleteInfoSendAs,
       Cmd.ARG_SMIME:		deleteSmime,
       Cmd.ARG_SHAREDDRIVE:	deleteSharedDrive,
-      Cmd.ARG_SITEACL:		processUserSiteACLs,
+      Cmd.ARG_SITEACL:		deprecatedUserSites,
       Cmd.ARG_TASK:		processTasks,
       Cmd.ARG_TASKLIST:		processTasklists,
       Cmd.ARG_THREAD:		processThreads,
@@ -76972,8 +76213,8 @@ USER_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SENDAS:		deleteInfoSendAs,
       Cmd.ARG_SHAREDDRIVE:	infoSharedDrive,
       Cmd.ARG_SHEET:		infoPrintShowSheets,
-      Cmd.ARG_SITE:		infoUserSites,
-      Cmd.ARG_SITEACL:		processUserSiteACLs,
+      Cmd.ARG_SITE:		deprecatedUserSites,
+      Cmd.ARG_SITEACL:		deprecatedUserSites,
       Cmd.ARG_TASK:		processTasks,
       Cmd.ARG_TASKLIST:		processTasklists,
       Cmd.ARG_USER:		infoUsers,
@@ -77085,9 +76326,9 @@ USER_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SHEETRANGE:	printShowSheetRanges,
       Cmd.ARG_SIGNATURE:	printShowSignature,
       Cmd.ARG_SMIME:		printShowSmimes,
-      Cmd.ARG_SITE:		printShowUserSites,
-      Cmd.ARG_SITEACL:		processUserSiteACLs,
-      Cmd.ARG_SITEACTIVITY:	printUserSiteActivity,
+      Cmd.ARG_SITE:		deprecatedUserSites,
+      Cmd.ARG_SITEACL:		deprecatedUserSites,
+      Cmd.ARG_SITEACTIVITY:	deprecatedUserSites,
       Cmd.ARG_TASK:		printShowTasks,
       Cmd.ARG_TASKLIST:		printShowTasklists,
       Cmd.ARG_THREAD:		printShowThreads,
@@ -77191,8 +76432,8 @@ USER_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SHEET:		infoPrintShowSheets,
       Cmd.ARG_SHEETRANGE:	printShowSheetRanges,
       Cmd.ARG_SIGNATURE:	printShowSignature,
-      Cmd.ARG_SITE:		printShowUserSites,
-      Cmd.ARG_SITEACL:		processUserSiteACLs,
+      Cmd.ARG_SITE:		deprecatedUserSites,
+      Cmd.ARG_SITEACL:		deprecatedUserSites,
       Cmd.ARG_SMIME:		printShowSmimes,
       Cmd.ARG_TASK:		printShowTasks,
       Cmd.ARG_TASKLIST:		printShowTasklists,
@@ -77295,8 +76536,8 @@ USER_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_SHEET:		updateSheets,
       Cmd.ARG_SHEETRANGE:	updateSheetRanges,
       Cmd.ARG_SMIME:		updateSmime,
-      Cmd.ARG_SITE:		updateUserSites,
-      Cmd.ARG_SITEACL:		processUserSiteACLs,
+      Cmd.ARG_SITE:		deprecatedUserSites,
+      Cmd.ARG_SITEACL:		deprecatedUserSites,
       Cmd.ARG_TASK:		processTasks,
       Cmd.ARG_TASKLIST:		processTasklists,
       Cmd.ARG_USER:		updateUsers,

gam/gamlib/glapi.py

@@ -89,7 +89,6 @@ SERVICEMANAGEMENT = 'servicemanagement'
 SERVICEUSAGE = 'serviceusage'
 SHEETS = 'sheets'
 SHEETSTD = 'sheetstd'
-SITES = 'sites'
 SITEVERIFICATION = 'siteVerification'
 STORAGE = 'storage'
 STORAGEREAD = 'storageread'
@@ -266,7 +265,6 @@ _INFO = {
   SERVICEUSAGE: {'name': 'Service Usage API', 'version': 'v1', 'v2discovery': True},
   SHEETS: {'name': 'Sheets API', 'version': 'v4', 'v2discovery': True},
   SHEETSTD: {'name': 'Sheets API - todrive', 'version': 'v4', 'v2discovery': True, 'mappedAPI': SHEETS},
-  SITES: {'name': 'Sites API', 'version': 'v1', 'v2discovery': False},
   SITEVERIFICATION: {'name': 'Site Verification API', 'version': 'v1', 'v2discovery': True},
   STORAGE: {'name': 'Cloud Storage API', 'version': 'v1', 'v2discovery': True},
   STORAGEREAD: {'name': 'Cloud Storage API - Read', 'version': 'v1', 'v2discovery': True, 'mappedAPI': STORAGE},
@@ -500,11 +498,6 @@ _CLIENT_SCOPES = [
    'subscopes': [],
    'offByDefault': True,
    'scope': 'https://www.googleapis.com/auth/siteverification'},
-  {'name': 'Sites API',
-   'api': SITES,
-   'subscopes': [],
-   'offByDefault': True,
-   'scope': 'https://sites.google.com/feeds'},
   {'name': 'Vault API',
    'api': VAULT,
    'subscopes': READONLY,
@@ -694,10 +687,6 @@ _SVCACCT_SCOPES = [
    'api': SHEETS,
    'subscopes': READONLY,
    'scope': 'https://www.googleapis.com/auth/spreadsheets'},
-  {'name': 'Sites API',
-   'api': SITES,
-   'subscopes': [],
-   'scope': 'https://sites.google.com/feeds'},
   {'name': 'Tasks API',
    'api': TASKS,
    'subscopes': READONLY,

gam/gamlib/glclargs.py

@@ -1150,6 +1150,10 @@ class GamCLArgs():
       return f'Command: {self.QuotedArgumentList(self.argv[:self.argvI])} >>>{self.QuotedArgumentList([self.argv[self.argvI]])}<<< {self.QuotedArgumentList(self.argv[self.argvI+1:])}\n'
     return f'Command: {self.QuotedArgumentList(self.argv)} >>><<<\n'
 
+# Deprecated command
+  def CommandDeprecated(self):
+    return f'{self.QuotedArgumentList(self.argv)}\n'
+
 # Peek to see if next argument is in choices
   def PeekArgumentPresent(self, choices):
     if self.ArgumentsRemaining():

gam/gamlib/glentity.py

@@ -342,8 +342,6 @@ class GamEntity():
   SHEET = 'shet'
   SHEET_ID = 'shti'
   SIGNATURE = 'sign'
-  SITE = 'site'
-  SITE_ACL = 'sacl'
   SIZE = 'size'
   SKU = 'sku '
   SMIME_ID = 'smid'
@@ -695,8 +693,6 @@ class GamEntity():
     SHEET: ['Sheets', 'Sheet'],
     SHEET_ID: ['Sheet IDs', 'Sheet ID'],
     SIGNATURE: ['Signatures', 'Signature'],
-    SITE: ['Sites', 'Site'],
-    SITE_ACL: ['Site ACLs', 'Site ACL'],
     SIZE: ['Sizes', 'Size'],
     SKU: ['SKUs', 'SKU'],
     SMIME_ID: ['S/MIME Certificate IDs', 'S/MIME Certificate ID'],

gam/gamlib/glmsgs.py

@@ -481,6 +481,7 @@ SERVICE_NOT_APPLICABLE = 'Service not applicable/Does not exist'
 SERVICE_NOT_APPLICABLE_THIS_ADDRESS = 'Service not applicable for this address: {0}'
 SERVICE_NOT_ENABLED = '{0} Service/App not enabled'
 SHORTCUT_TARGET_CAPABILITY_IS_FALSE = '{0} capability {1} is False'
+SITES_COMMAND_DEPRECATED = 'The Classic Sites API is deprecated, this command will not work:\n{0}'
 SKU_HAS_NO_MATCHING_ARCHIVED_USER_SKU = 'SKU {0} has no matching Archived User SKU'
 STARTING_THREAD = 'Starting thread'
 STATISTICS_COPY_FILE = 'Total: {0}, Copied: {1}, Shortcut created {2}, Shortcut exists {3}, Duplicate: {4}, Copy Failed: {5}, Not copyable: {6}, In skipids: {7}, Permissions Failed: {8}, Protected Ranges Failed: {9}'

{gam7-7.3.9.dist-info → gam7-7.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gam7
-Version: 7.3.9
+Version: 7.4.1
 Summary: CLI tool to manage Google Workspace
 Project-URL: Homepage, https://github.com/GAM-team/GAM
 Project-URL: Issues, https://github.com/GAM-team/GAM/issues

{gam7-7.3.9.dist-info → gam7-7.4.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-gam/__init__.py,sha256=XPvY7SEYLr2Eehx9ZaOv0gG_W8Zeq394eAzGA6Qs70M,3500602
+gam/__init__.py,sha256=TVtDzftfoUVfeees4B_zmjxR3QmMDByRTKrN_qzBdN4,3471510
 gam/__main__.py,sha256=amz0-959ph6zkZKqjaar4n60yho-T37w6qWI36qx0CA,1049
 gam/cacerts.pem,sha256=nJuWha0xm5dHw_5ptGphwRoO-r36Ccpqiww9pCEDbSc,67484
 gam/cbcm-v1.1beta1.json,sha256=xO5XloCQQULmPbFBx5bckdqmbLFQ7sJ2TImhE1ysDIY,19439
@@ -22,15 +22,15 @@ gam/atom/token_store.py,sha256=7E6Ecvxa86WCvl1pJAhv78jg9OxQv8pMtIUcPhZCq04,3803
 gam/atom/url.py,sha256=pxO1TlORxyKQTQ1bkBE1unFzjnv9c8LjJkm-UEORShY,4276
 gam/gamlib/__init__.py,sha256=z5mF-y0j8pm-YNFBaiuxB4M_GAUPG-cXWwrhYwrVReM,679
 gam/gamlib/glaction.py,sha256=1Il_HrChVnPkzZwiZs5au4mFQVtq4K1Z42uIuR6qdnI,9419
-gam/gamlib/glapi.py,sha256=t8E0oM1negh5PydXDyzKoer-vjuCLGHcw7bh4NBs_dY,34499
+gam/gamlib/glapi.py,sha256=AkZRK0ebSBn7iJApTZl2crRWY3-D0vNmwTI36ZEo34s,34171
 gam/gamlib/glcfg.py,sha256=3ix3GFXP8riaD4z4ubt4qUCxznhmLU-bZHCw8TxLiz8,27484
-gam/gamlib/glclargs.py,sha256=nB366gRthM0fHQpWbWWuWRBCnKvlcfB5cejFZfx0Xdc,42094
-gam/gamlib/glentity.py,sha256=4DGlmRxugViY1K3zObva8ByL3yA9sccXxjAVQz-xIjg,33907
+gam/gamlib/glclargs.py,sha256=ptSTGELZHQS6SfvGGJ3NrXRoHAToO108NTYsFQE-C4c,42200
+gam/gamlib/glentity.py,sha256=ZLbyMl9NhN-MBf9Rxmho2dBYeS4SNLMctpeaKFZSbQ4,33801
 gam/gamlib/glgapi.py,sha256=W1nFH0sY7P8pnb98_4uzMSCs8gre0rvG5pBRI6HJq0c,38274
 gam/gamlib/glgdata.py,sha256=weRppttWm6uRyqtBoGPKoHiNZ2h28nhfUV4J_mbCszY,2707
 gam/gamlib/glglobals.py,sha256=B0kCz4K6PO1-n3eZI_lvdRG99Ane1-dH4zS4J4aymlI,9566
 gam/gamlib/glindent.py,sha256=RfBa2LDfLIqPLL5vMfC689TCVmqn8xf-qulSzkiatrc,1228
-gam/gamlib/glmsgs.py,sha256=Evdd4lEXGFPaf7m0IOt_MJbQZ40Gauma5NlOyGO4M1I,33103
+gam/gamlib/glmsgs.py,sha256=HzISx_btqbwOKjMm2rokV4-Y1BMDS04-bwu6fa92XCo,33202
 gam/gamlib/glskus.py,sha256=S-OasG1SteZSV0cG8JM74L3wFp9sozoZd39fTXajQWc,14159
 gam/gamlib/gluprop.py,sha256=IyPLCyvn7-NHTUenM71YPQPXRZXx6CB5q-GtJ-FYd1c,11461
 gam/gamlib/glverlibs.py,sha256=XXYhmjOVti78JTy7NNr4ShIwiOX7LrfrmFSlqSWixrE,1077
@@ -66,8 +66,8 @@ gam/googleapiclient/discovery_cache/base.py,sha256=yCDPtxnbNN-p5_9fzBacC6P3wcUPl
 gam/googleapiclient/discovery_cache/file_cache.py,sha256=sim3Mg4HgRYo3vX75jvcKy_aV568EvIrtBfvfbw-044,4774
 gam/iso8601/__init__.py,sha256=Z2PsYbXgAH5a5xzUvgczCboPzqWpm65kRcIngCnhViU,1218
 gam/iso8601/iso8601.py,sha256=Li2FHZ4sBTWuthuQhyCvmvj0j6At8JbGzkSv2fc2RHU,4384
-gam7-7.3.9.dist-info/METADATA,sha256=JWBdFrsHj2n57HCMqC8M5E8pt081CRd_8k-djkiDZZg,2888
-gam7-7.3.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-gam7-7.3.9.dist-info/entry_points.txt,sha256=HVUM5J7dA8YwvJfG30jiLefR19ExMs387TWugWd9sf4,42
-gam7-7.3.9.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-gam7-7.3.9.dist-info/RECORD,,
+gam7-7.4.1.dist-info/METADATA,sha256=CtD82jtdLbj0wYtnKS0VoRQ0xCwE4rO-_PDDKjONh9g,2888
+gam7-7.4.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+gam7-7.4.1.dist-info/entry_points.txt,sha256=HVUM5J7dA8YwvJfG30jiLefR19ExMs387TWugWd9sf4,42
+gam7-7.4.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+gam7-7.4.1.dist-info/RECORD,,