Every request CaseDesk makes to your Google account

GET /gmail/v1/users/me/profile
Authorization: Bearer <access_token>

{
  "emailAddress": "you@gmail.com",
  "messagesTotal": 18452,
  "threadsTotal": 9311,
  "historyId": "4823907"
}

GET /gmail/v1/users/me/messages
  ?q=from:(claims@northfield-insurance.example
        OR support@harbourbank.example)
     after:1760572800
  &maxResults=100
Authorization: Bearer <access_token>

{
  "messages": [
    { "id": "192f3a7c1b8e4d20", "threadId": "192f3a7c1b8e4d20" },
    { "id": "192f2c90ab31f7e5", "threadId": "192ef01d55c2a9b8" }
  ],
  "resultSizeEstimate": 2
}

GET /gmail/v1/users/me/history
  ?startHistoryId=4823907
  &historyTypes=messageAdded
  &labelId=INBOX
Authorization: Bearer <access_token>

{
  "history": [
    {
      "id": "4823951",
      "messagesAdded": [
        { "message": {
            "id": "192f4be01a77c3d9",
            "threadId": "192f3a7c1b8e4d20",
            "labelIds": ["INBOX", "UNREAD"]
        } }
      ]
    }
  ],
  "historyId": "4823988"
}

GET /gmail/v1/users/me/messages/192f4be01a77c3d9
  ?format=full
Authorization: Bearer <access_token>

{
  "id": "192f4be01a77c3d9",
  "threadId": "192f3a7c1b8e4d20",
  "internalDate": "1760604512000",
  "snippet": "We have received your claim regarding...",
  "payload": {
    "mimeType": "multipart/mixed",
    "headers": [
      { "name": "From", "value": "Claims Team <claims@northfield-insurance.example>" },
      { "name": "Subject", "value": "Claim update needed for policy #44821" },
      { "name": "Date", "value": "Thu, 16 Oct 2026 14:08:32 +0530" },
      { "name": "Message-ID", "value": "<a81c@northfield-insurance.example>" }
    ],
    "parts": [
      { "partId": "0", "mimeType": "text/plain",
        "body": { "size": 412, "data": "SGVsbG8sDQoNCldlIGhhdmUg..." } },
      { "partId": "1", "mimeType": "application/pdf",
        "filename": "Claim_Form_44821.pdf",
        "body": { "attachmentId": "ANGjdJ8w...Qx", "size": 217088 } }
    ]
  }
}

GET /gmail/v1/users/me/messages/192f4be01a77c3d9
    /attachments/ANGjdJ8w...Qx
Authorization: Bearer <access_token>

{
  "attachmentId": "ANGjdJ8w...Qx",
  "size": 217088,
  "data": "JVBERi0xLjcKJeLjz9MKNSAwIG9iago8PC9G..."
}

const blob = Utilities.newBlob(
  Utilities.base64DecodeWebSafe(att.data),
  'application/pdf',
  'CASE-0007_Claim_Form_44821.pdf'
);
const file = folder.createFile(blob);

{
  "id": "1Xq8vR2mT0bLkP4sWcZ9yHn3",
  "name": "CASE-0007_Claim_Form_44821.pdf",
  "mimeType": "application/pdf",
  "webViewLink": "https://drive.google.com/file/d/1Xq8.../view"
}

google.script.run
  .withSuccessHandler(render)
  .listCases({ limit: 50, offset: 0 });

{
  "counts": { "total": 7, "Open": 3, "In Progress": 2, "Closed": 2 },
  "cases": [
    {
      "caseNumber": "CASE-0007",
      "received": "2026-10-16T08:38:32Z",
      "sender": "claims@northfield-insurance.example",
      "subject": "Claim update needed for policy #44821",
      "issue": "",
      "status": "Open",
      "emailCount": 1
    }
  ]
}

google.script.run
  .withSuccessHandler(showCase)
  .getCase('CASE-0007');

{
  "caseNumber": "CASE-0007",
  "threadId": "192f3a7c1b8e4d20",
  "status": "In Progress",
  "issue": "Water damage claim, kitchen",
  "notes": "Sent photos Monday.",
  "messages": [
    {
      "messageId": "192f4be01a77c3d9",
      "from": "claims@northfield-insurance.example",
      "date": "2026-10-16T08:38:32Z",
      "subject": "Claim update needed for policy #44821",
      "body": "Hello,\n\nWe have received your claim...",
      "attachments": [
        { "name": "Claim_Form_44821.pdf", "size": 217088,
          "driveUrl": "https://drive.google.com/file/d/1Xq8.../view" }
      ]
    }
  ]
}

google.script.run.updateCase('CASE-0007', {
  issue: 'Water damage claim, kitchen',
  status: 'In Progress',
  notes: 'Sent photos Monday. Waiting on estimate.'
});

{
  "ok": true,
  "caseNumber": "CASE-0007",
  "updatedAt": "2026-10-16T09:02:11Z"
}

// Invalid status:
{ "ok": false, "error": "Status must be Open, In Progress or Closed" }

google.script.run.searchCases({
  caseNumber: '',
  keyword: 'refund',     // subject, body, sender, notes
  issue: '',
  status: 'Closed',
  from: '2026-09-01',
  to: '2026-10-16'
});

{
  "count": 1,
  "cases": [
    { "caseNumber": "CASE-0003", "status": "Closed",
      "issue": "Refund for cancelled subscription",
      "received": "2026-10-05T11:20:00Z" }
  ]
}

google.script.run.saveSettings({
  senders: [
    'claims@northfield-insurance.example',
    'support@harbourbank.example'
  ],
  emailAlerts: true,
  alertEmail: 'you@gmail.com'
});

{
  "ok": true,
  "senders": ["claims@northfield-insurance.example", "support@harbourbank.example"],
  "emailAlerts": true
}

// Bad address:
{ "ok": false, "error": "\"harbourbank\" isn't a valid email address" }