Create a tracker activity

This page describes how to create a tracker activity.

Overview

Activities describe at a very granular level an action performed by a user or group of users (i.e. audiences) such as user X watched episode N from 00:00 to 05:00 on the 20th of September 2022 starting at 2:37pm and finishing at 2:42pm on Netflix.

Sample

The following sample shows how to create a tracker activity.

Replace [TRACKER] with the resource name of the tracker the activity belong to, e.g. users/123/trackers/456.

Replace [RESOURCE] with the resource name of the resource (chapters or episodes) to be tracked, e.g. animes/123/episodes/456.

tip

Tip: do not forget to replace CLIENT-ID and CLIENT-SECRET with valid IAM Service Account client credentials.

Golang

package main

import (
	"context"
	"log"

	"golang.org/x/oauth2/clientcredentials"

	"google.golang.org/api/option"
	"google.golang.org/protobuf/types/known/timestamppb"

	gapic "github.com/animeapis/api-go-client/tracker/v1alpha1"
	tracker "github.com/animeapis/go-genproto/tracker/v1alpha1"
)

var (
	Tracker  = "[TRACKER]"
	Resource = "[RESOURCE]"

	ClientID     = "[CLIENT-ID]"
	ClientSecret = "[CLIENT-SECRET]"
)

var (
	TokenURL = "https://accounts.animeshon.com/o/oauth2/token"
	Endpoint = "tracker.animeapis.com:443"
)

func main() {
	ctx := context.Background()

	config := &clientcredentials.Config{
		ClientID:     ClientID,
		ClientSecret: ClientSecret,
		TokenURL:     TokenURL,
	}

	options := []option.ClientOption{
		option.WithEndpoint(Endpoint),
		option.WithTokenSource(config.TokenSource(ctx)),
	}

	client, err := gapic.NewClient(ctx, options...)
	if err != nil {
		log.Fatalf("NewClient: %s", err)
	}

	request := &tracker.CreateActivityRequest{
		Parent: Tracker,
		Activity: &tracker.Activity{
			Resource:  Resource,
			Platform:  "NETFLIX",
			From:      0,
			To:        22 * 60,
			StartTime: timestamppb.Now(),
			EndTime:   timestamppb.Now(),
		},
	}

	response, err := client.CreateActivity(ctx, request)
	if err != nil {
		log.Fatalf("CreateActivity: %s", err)
	}

	log.Printf("name      : %s", response.GetName())
	log.Printf("resource  : %s", response.GetResource())
	log.Printf("platform  : %s", response.GetPlatform())
	log.Printf("from      : %d", response.GetFrom())
	log.Printf("to        : %d", response.GetTo())
	log.Printf("start time: %s", response.GetStartTime().AsTime().String())
	log.Printf("end time  : %s", response.GetEndTime().AsTime().String())
}

View on GitHub