Add support for user related information

fixture/GET/user_related.json

@@ -0,0 +1,8 @@
+{
+  "user_related": {
+    "assigned_tickets": 5,
+    "ccd_tickets": 3,
+    "organization_subscriptions": 1,
+    "requested_tickets": 10
+  }
+}

zendesk/user.go

@@ -91,13 +91,24 @@ type GetManyUsersOptions struct {
 	IDs         string `json:"ids,omitempty" url:"ids,omitempty"`
 }
 
+// UserRelated contains user related data
+//
+// ref: https://developer.zendesk.com/api-reference/ticketing/users/users/#show-user-related-information
+type UserRelated struct {
+	AssignedTickets           int64 `json:"assigned_tickets"`
+	RequestedTickets          int64 `json:"requested_tickets"`
+	CCDTickets                int64 `json:"ccd_tickets"`
+	OrganizationSubscriptions int64 `json:"organization_subscriptions"`
+}
+
 // UserAPI an interface containing all user related methods
 type UserAPI interface {
 	GetManyUsers(ctx context.Context, opts *GetManyUsersOptions) ([]User, Page, error)
 	GetUsers(ctx context.Context, opts *UserListOptions) ([]User, Page, error)
 	GetUser(ctx context.Context, userID int64) (User, error)
 	CreateUser(ctx context.Context, user User) (User, error)
 	UpdateUser(ctx context.Context, userID int64, user User) (User, error)
+	GetUserRelated(ctx context.Context, userID int64) (UserRelated, error)
 }
 
 // GetUsers fetch user list
@@ -223,3 +234,22 @@ func (z *Client) UpdateUser(ctx context.Context, userID int64, user User) (User,
 	}
 	return result.User, nil
 }
+
+// GetUserRelated retrieves user related user information
+// ref: https://developer.zendesk.com/api-reference/ticketing/users/users/#show-user-related-information
+func (z *Client) GetUserRelated(ctx context.Context, userID int64) (UserRelated, error) {
+	var data struct {
+		UserRelated UserRelated `json:"user_related"`
+	}
+
+	body, err := z.get(ctx, fmt.Sprintf("/users/%d/related.json", userID))
+	if err != nil {
+		return UserRelated{}, err
+	}
+
+	if err := json.Unmarshal(body, &data); err != nil {
+		return UserRelated{}, err
+	}
+
+	return data.UserRelated, nil
+}

zendesk/user_test.go

@@ -141,3 +141,19 @@ func TestUpdateUserFailure(t *testing.T) {
 		t.Fatal("Client did not return error when api failed")
 	}
 }
+
+func TestGetUserRelated(t *testing.T) {
+	mockAPI := newMockAPIWithStatus(http.MethodGet, "user_related.json", http.StatusOK)
+	client := newTestClient(mockAPI)
+	defer mockAPI.Close()
+
+	userRelated, err := client.GetUserRelated(ctx, 369531345753)
+	if err != nil {
+		t.Fatalf("Failed to get user related information: %s", err)
+	}
+
+	expectedAssignedTickets := int64(5)
+	if userRelated.AssignedTickets != expectedAssignedTickets {
+		t.Fatalf("Returned user does not have the expected assigned tickets %d. It is %d", expectedAssignedTickets, userRelated.AssignedTickets)
+	}
+}