(20241205) Migrating from the field "accountId" to "tokenId" to identify auth tokens.

api/blueprints/mail/oauth_request.py

@@ -175,7 +175,7 @@ async def request_oauth_authorization_url(
     #            ┛
 
     # Make a user identifier from the session info:
-    user_identifier = await current_app.mail_oauth_model.get_account_identifier(
+    token_id = await current_app.mail_oauth_model.get_token_id(
         db_conn = current_app.sql_writer,
         mongo_conn = current_app.data_mongo,
         session_token = inbound_headers["X-Session-Token"],
@@ -184,13 +184,13 @@ async def request_oauth_authorization_url(
         service_client = inbound_data.mailClient,
         auth_type = "oauth"
     )
-    if user_identifier is None:
+    if token_id is None:
         return ResponseModel(
             status_code = StatusCodes.FAILED,
             http_code = HttpCodes.INTERNAL_SERVER_ERROR,
-            message = "failed to generate user identifier"
+            message = "failed to generate token id"
         )
-    user_identifier = str(user_identifier)
+    token_id = str(token_id)
 
     # ┏┓      ┏┓┳┳┓  •┓
     # ┣ ┏┓┏┓  ┃┓┃┃┃┏┓┓┃
@@ -201,7 +201,7 @@ async def request_oauth_authorization_url(
         # Get the authorization URL:
         auth_url = await current_app.gmail_client.get_authorization_url(
             scopes = SCOPES_GMAIL_MAIL_MANAGEMENT,
-            state = user_identifier,
+            state = token_id,
             access_type = "offline",
             approval_prompt = "force",
             include_granted_scopes = "true",