Sample code for 30+ languages & platforms
Objective-C Requires Chilkat v11.0.0+

List Gmail message IDs across all pages

See more GMail REST API Examples

List message and thread IDs for the authenticated user. Continue with nextPageToken until it is absent. A message ID is a Gmail identifier, distinct from the RFC Message-ID header. Use it in the reading examples. Spam and Trash are excluded by default.

Authorize the application with https://www.googleapis.com/auth/gmail.readonly. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat Objective-C Downloads

Objective-C
#import <CkoJsonObject.h>
#import <CkoHttp.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>

BOOL success = NO;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

CkoJsonObject *token = [[CkoJsonObject alloc] init];
success = [token LoadFile: @"gmail-token.json"];
if (success != YES) {
    NSLog(@"%@",@"Could not read gmail-token.json from the private working directory.");
    return;
}

if (([[token JsonTypeOf: @"access_token"] intValue] != 1) || ([token StringOfEquals: @"access_token" value: @"" caseSensitive: YES] == YES)) {
    NSLog(@"%@",@"An OAuth access token is required.");
    return;
}

CkoHttp *http = [[CkoHttp alloc] init];
http.RequireSslCertVerify = YES;
http.AuthToken = [token StringOf: @"access_token"];
CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
CkoJsonObject *reply = [[CkoJsonObject alloc] init];
int total = 0;
CkoStringBuilder *baseUrl = [[CkoStringBuilder alloc] init];
[baseUrl Append: @"https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=100"];
CkoStringBuilder *url = [[CkoStringBuilder alloc] init];
CkoStringBuilder *pageToken = [[CkoStringBuilder alloc] init];
BOOL more = YES;
while ((more == YES)) {
    [url SetString: [baseUrl GetAsString]];
    if ([pageToken.Length intValue] > 0) {
        [url Append: @"&pageToken="];
        [url Append: [http UrlEncode: [pageToken GetAsString]]];
    }

    success = [http HttpNoBody: @"GET" url: [url GetAsString] response: resp];
    if ([resp.StatusCode intValue] == 0) {
        NSLog(@"%@",@"Gmail did not return an HTTP response.");
        return;
    }

    if ((success != YES) || ([resp.StatusCode intValue] < 200) || ([resp.StatusCode intValue] >= 300)) {
        NSLog(@"%@%d",@"Gmail HTTP ",[resp.StatusCode intValue]);
        success = [reply Load: resp.BodyStr];
        if (success == YES) {
            NSLog(@"%@",[reply StringOf: @"error.message"]);
        }

        return;
    }

    success = [reply Load: resp.BodyStr];
    if (success != YES) {
        NSLog(@"%@",@"Expected a Gmail JSON response.");
        return;
    }

    //  Gmail can omit messages when the search or mailbox is empty.
    int count = [[reply SizeOfArray: @"messages"] intValue];
    int i = 0;
    while ((i < count)) {
        reply.I = [NSNumber numberWithInt: i];
        NSLog(@"%@%@%@",[reply StringOf: @"messages[i].id"],@"  thread ",[reply StringOf: @"messages[i].threadId"]);
        total = total + 1;
        i = i + 1;
    }

    more = NO;
    if ([[reply JsonTypeOf: @"nextPageToken"] intValue] == 1) {
        [pageToken SetString: [reply StringOf: @"nextPageToken"]];
        more = [pageToken.Length intValue] > 0;
    }

}

NSLog(@"%@%d",@"Messages listed: ",total);