List Memos
ListMemos lists the memos the caller can read, excluding comments. Anonymous callers can list only when the instance allows public access.
Query Parameters
Optional. The maximum number of memos to return. The service may return fewer. Defaults to 50; values above 1000 are coerced to 1000.
int32Optional. A page token from a previous call. Provide it to retrieve the next page.
Optional. A CEL expression to filter memos. Combine terms with && and ||.
Available fields:
content (string), creator (string, e.g. "users/1"),
created_ts / updated_ts (timestamp), pinned (bool),
visibility (string: PRIVATE | PROTECTED | PUBLIC | SPACE),
space (string resource name, or null when the memo has no space;
supports == and comparisons against null, e.g. space != null),
tags (list; match with "work" in tags, not tag == "work"),
has_task_list / has_link / has_code / has_incomplete_tasks (bool),
has_location (bool; true when the memo has a location attached).
Note: the time fields here are created_ts / updated_ts, which differ from
the create_time / update_time names used by order_by.
Examples:
pinned == true && visibility == "PUBLIC"
space == "spaces/team" or space == null
tags.exists(t, t == "urgent")
content.contains("roadmap") && created_ts > now - duration("168h")
Optional. The order to sort results by, as a comma-separated list of fields following AIP-132. Defaults to "create_time desc". Supported fields: pinned, create_time, update_time, name. Example: "pinned desc, create_time desc" or "update_time asc". Note: order_by uses create_time / update_time, while the filter expression uses created_ts / updated_ts for the same timestamps.
Optional. Whether to include deleted memos. Currently ignored by the server.
Optional. The state of the memos to list. Defaults to NORMAL. Set to ARCHIVED to list the caller's own archived memos.
enumValue in
- "STATE_UNSPECIFIED"
- "NORMAL"
- "ARCHIVED"
Response Body
application/json
application/json
curl -X GET "https://example.com/api/memos"{ "memos": [ { "name": "string", "creator": "string", "space": "string", "content": "string", "location": { "placeholder": "string", "latitude": 0.1, "longitude": 0.1 }, "visibility": "VISIBILITY_UNSPECIFIED", "state": "STATE_UNSPECIFIED", "pinned": true, "attachments": [ { "name": "string", "creator": "string", "filename": "string", "type": "string", "content": "string", "externalLink": "string", "motionMedia": { "family": "MOTION_MEDIA_FAMILY_UNSPECIFIED", "role": "MOTION_MEDIA_ROLE_UNSPECIFIED", "groupId": "string", "presentationTimestampUs": "string", "hasEmbeddedVideo": true }, "mediaMetadata": { "width": 0, "height": 0, "photo": { "captureTime": { "localDateTime": "string", "utcOffset": "string" }, "location": { "latitude": 0.1, "longitude": 0.1, "altitudeMeters": 0.1 }, "sourceExifOrientation": 0, "cameraMake": "string", "cameraModel": "string", "lensModel": "string", "fNumber": 0.1, "exposureTimeSeconds": 0.1, "iso": 0, "focalLengthMm": 0.1 }, "video": { "durationSeconds": 0.1 } }, "memo": "string", "size": "string", "createTime": "2019-08-24T14:15:22Z" } ], "relations": [ { "memo": { "name": "string", "snippet": "string" }, "relatedMemo": { "name": "string", "snippet": "string" }, "type": "TYPE_UNSPECIFIED" } ], "reactions": [ { "name": "string", "creator": "string", "reactionType": "string", "createTime": "2019-08-24T14:15:22Z" } ], "parent": "string", "tags": [ "string" ], "property": { "title": "string", "hasLink": true, "hasCode": true, "hasTaskList": true, "hasIncompleteTasks": true }, "snippet": "string", "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z" } ], "nextPageToken": "string"}List Memo Shares
ListMemoShares lists all share links for a memo. Requires the memo creator or an instance administrator.
Set Memo Attachments
SetMemoAttachments replaces the full set of attachments on a memo with the provided list (not an append). Pass the complete desired set; an empty list clears all attachments. Idempotent. Requires the memo creator or an instance administrator.