Builder Pattern

The SDK uses a fluent builder pattern for constructing API requests.

Basic Request Building

request := builder.New(http.MethodGet, "v3/blogs/{blogId}").
    Context(ctx).
    Param("blogId", blogId)

Options Pattern

Each service exposes option types that customize requests:

posts, err := client.Posts().List(ctx, blogId,
    blogger.WithMaxResults(10),
    blogger.WithStatus(blogger.PostStatusLive),
    blogger.WithLabels("news", "events"),
)

Common Options

Pagination

blogger.WithPageToken("nextPageToken")
blogger.WithMaxResults(10)

Filtering

blogger.WithStatus("LIVE")      // Post/Comment status
blogger.WithLabels("tag1")      // Post labels
blogger.WithStartDate("2024-01-01")
blogger.WithEndDate("2024-12-31")

Ordering

blogger.WithOrderBy("published") // "published" or "updated"
blogger.WithSortOrder("DESCENDING")

View Types

blogger.WithView(blogger.ViewAdmin) // "READER", "AUTHOR", "ADMIN"

Status Constants

// Post statuses
blogger.PostStatusLive        = "LIVE"
blogger.PostStatusDraft       = "DRAFT"
blogger.PostStatusScheduled   = "SCHEDULED"
blogger.PostStatusSoftTrashed = "SOFT_TRASHED"

// Comment statuses
blogger.CommentStatusLive     = "LIVE"
blogger.CommentStatusEmptied  = "EMPTIED"
blogger.CommentStatusPending  = "PENDING"
blogger.CommentStatusSpam     = "SPAM"

// Page statuses
blogger.PageStatusLive        = "LIVE"
blogger.PageStatusDraft       = "DRAFT"
blogger.PageStatusSoftTrashed = "SOFT_TRASHED"