Objective-C GMail: Search for Messages with Subject Containing a Word

Back to Index

Return messages matching the specified query. See https://support.google.com/mail/answer/7190?hl=en for additional information about search operators. This example searches for all emails having the whole word "ADVChina" in the subject.

Documentation: https://support.google.com/mail/answer/7190?hl=en

CURL Command

curl -X GET https://www.googleapis.com/gmail/v1/users/me/messages?q=subject:ADVChina \
    --header "Authorization: Bearer GMAIL_TOKEN"

Objective-C Example

#import <CkoRest.h>
#import <CkoStringBuilder.h>
#import <CkoJsonObject.h>
#import <NSString.h>

CkoRest *rest = [[CkoRest alloc] init];
BOOL success;

//  URL: https://www.googleapis.com/gmail/v1/users/me/messages?q=subject:ADVChina
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
success = [rest Connect: @"www.googleapis.com" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@%d",@"ConnectFailReason: ",[rest.ConnectFailReason intValue]);

[rest AddHeader: @"Authorization" value: @"Bearer GMAIL_TOKEN"];

CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
success = [rest FullRequestNoBodySb: @"GET" uriPath: @"/gmail/v1/users/me/messages?q=subject:ADVChina" sb: sbResponseBody];
if (success != YES) {

int respStatusCode = [rest.ResponseStatusCode intValue];
if (respStatusCode >= 400) {
    NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",@"Response Body:");
    NSLog(@"%@",[sbResponseBody GetAsString]);

CkoJsonObject *jsonResponse = [[CkoJsonObject alloc] init];
[jsonResponse LoadSb: sbResponseBody];

//  See the Online Tool for Generating JSON Parse Code
int i;
int count_i;

int resultSizeEstimate = [[jsonResponse IntOf: @"resultSizeEstimate"] intValue];
i = 0;
count_i = [[jsonResponse SizeOfArray: @"messages"] intValue];
while (i < count_i) {
    jsonResponse.I = [NSNumber numberWithInt: i];
    NSString *id = [jsonResponse StringOf: @"messages[i].id"];
    NSString *threadId = [jsonResponse StringOf: @"messages[i].threadId"];
    i = i + 1;

Sample JSON Response Body

  "messages": [
      "id": "166e50fed0b9b0cb",
      "threadId": "166e50fed0b9b0cb"
      "id": "166c12e5fee013fe",
      "threadId": "166c12e5fee013fe"
      "id": "1669cc9a926bb8c1",
      "threadId": "1669cc9a926bb8c1"
      "id": "16678c485e7f0a0c",
      "threadId": "16678c485e7f0a0c"
  "resultSizeEstimate": 4