PTGUgoogle

README

PTGU Google

Import

import (
	PTGUgoogle "github.com/parinyapt/golang_utils/google/v1"
)

Example

Generate Access Token

google := PTGUgoogle.NewGoogle(&PTGUgoogle.GoogleConfig{
  GenerateAccessToken: PTGUgoogle.GoogleConfigGenerateAccessToken{
    ClientEmail:  "xxx@xxx.iam.gserviceaccount.com",
    PrivateKeyID: "xxxxxx",
    PrivateKey:   "-----BEGIN PRIVATE KEY-----\nXXXXXXXXXXXXXXXXXXXXXXX\n-----END PRIVATE KEY-----\n",
    Scopes: []string{
      "https://www.googleapis.com/xxxxx",
    },
  },
})
token, err := google.GenerateGoolgeAccessTokenWithoutOAuth(context.Background())
if err != nil {
  panic(err)
}
fmt.Println(token)

Documentations:

• Create Service Account (https://developers.google.com/identity/protocols/oauth2/service-account)

Verify Google Play Product Purchase

• Don't forget to add scope https://www.googleapis.com/auth/androidpublisher in Scopes when generate access token

googleToken := PTGUgoogle.NewGoogle(&PTGUgoogle.GoogleConfig{
  AccessToken: token,
})
response, err := googleToken.ValidateGoogleProductPurchase(PTGUgoogle.GooglePurchaseValidateParam{
  PackageName:   "com.xxx.xxx",
  ProductID:     "prinpt_1",
  PurchaseToken: "XXXXXX",
})
if err != nil {
  panic(err)
}
fmt.Println(response.OrderID)
fmt.Println(response.PurchaseTimeMillis)

Verify Google Play Subscription Purchase

• Don't forget to add scope https://www.googleapis.com/auth/androidpublisher in Scopes when generate access token

googleToken := PTGUgoogle.NewGoogle(&PTGUgoogle.GoogleConfig{
  AccessToken: token,
})
response, err := googleToken.ValidateGoogleSubscriptionsPurchase(PTGUgoogle.GoogleSubscriptionsPurchaseValidateParam{
  PackageName:   "com.xxx.xxx",
  PurchaseToken: "XXXXXX",
})
if err != nil {
  panic(err)
}
fmt.Println(response.subscriptionState)
fmt.Println(response.latestOrderId)

if response.LinkedPurchaseToken != nil {
  fmt.Println(PTGUdata.PointerToStringValue(response.LinkedPurchaseToken))
}else{
  fmt.Println("Response LinkedPurchaseToken is nil")
}

Documentations:

• Config and Give Permission to Service Account - Google Play Developer API (https://developers.google.com/android-publisher/getting_started)
• Fix error insufficient permissions (https://stackoverflow.com/questions/43536904/google-play-developer-api-the-current-user-has-insufficient-permissions-to-pe)

Reference:

• https://medium.com/tech-at-tdg/secret-sauce-%E0%B8%A1%E0%B8%B2%E0%B8%97%E0%B8%B3%E0%B8%A3%E0%B8%B0%E0%B8%9A%E0%B8%9A-receipt-verification-in-app-purchase-%E0%B8%81%E0%B8%B1%E0%B8%99%E0%B9%80%E0%B8%96%E0%B8%AD%E0%B8%B0-fe529184cd0a
• https://medium.com/tech-at-tdg/secret-sauce-%E0%B8%A1%E0%B8%B2%E0%B8%97%E0%B8%B3%E0%B8%A3%E0%B8%B0%E0%B8%9A%E0%B8%9A-receipt-verification-in-app-purchase-%E0%B8%81%E0%B8%B1%E0%B8%99%E0%B9%80%E0%B8%96%E0%B8%AD%E0%B8%B0-part-ii-android-37beb6b8b047
• https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Documentation

Index

• Constants
• func NewGoogle(inputConfig *GoogleConfig) *googleReceiverArgument
• type GoogleConfig
• type GoogleConfigGenerateAccessToken
• type GoogleProductPurchaseResponse
• type GooglePurchaseValidateParam
• type GooglePurchaseValidateResponseError
• type GoogleSubscriptionsPurchaseResponse
• type GoogleSubscriptionsPurchaseValidateParam
• type SubscriptionCanceledStateContext
• type SubscriptionPausedStateContext
• type SubscriptionPurchaseLineItem
• type SubscriptionPurchaseLineItemAutoRenewingPlan
• type SubscriptionPurchaseLineItemOfferDetails
• type SubscriptionPurchaseLineItemPrepaidPlan
• type SubscriptionUserInitiatedCancellation
• type SubscriptionUserInitiatedCancellationCancelSurveyResult

Constants

const (
	GoogleProductPurchaseURL = "" /* 132-byte string literal not displayed */
)

const (
	GoogleSubscriptionsPurchaseV2URL = "" /* 127-byte string literal not displayed */
)

Functions

func NewGoogle

func NewGoogle(inputConfig *GoogleConfig) *googleReceiverArgument

Types

type GoogleConfig

type GoogleConfig struct {
	GenerateAccessToken GoogleConfigGenerateAccessToken
	AccessToken         string
}

type GoogleConfigGenerateAccessToken

type GoogleConfigGenerateAccessToken struct {
	// Client Email from service account json file
	ClientEmail string

	// Private Key ID from service account json file
	PrivateKeyID string

	// Private Key from service account json file
	// PrivateKey contains the contents of an RSA private key or the
	// contents of a PEM file that contains a private key. The provided
	// private key is used to sign JWT payloads.
	// PEM containers with a passphrase are not supported.
	// Use the following command to convert a PKCS 12 file into a PEM.
	//
	//    $ openssl pkcs12 -in key.p12 -out key.pem -nodes
	//
	PrivateKey string

	// Scopes optionally specifies a list of requested permission scopes.
	Scopes []string
}

type GoogleProductPurchaseResponse

type GoogleProductPurchaseResponse struct {
	OrderID            string `json:"orderId"`
	PurchaseTimeMillis string `json:"purchaseTimeMillis"`
	DeveloperPayload   string `json:"developerPayload"`

	// Ex. androidpublisher#productPurchase
	Kind string `json:"kind"`

	/* Purchase State
	0 - Purchased
	1 - Canceled
	2 - Pending
	*/
	PurchaseState int `json:"purchaseState"`

	/* Consumption State
	0 - Yet to be consumed
	1 - Consumed
	*/
	ConsumptionState int `json:"consumptionState"`

	/* Purchase Type
	0 - Test (i.e. purchased from a license testing account)
	1 - Promo (i.e. purchased using a promo code)
	2 - Rewarded (i.e. from watching a video ad instead of paying)
	*/
	PurchaseType int `json:"purchaseType"`

	/* Acknowledgement State
	0 - Yet to be acknowledged
	1 - Acknowledged
	*/
	AcknowledgementState int `json:"acknowledgementState"`

	// Region Code - ISO 3166-1 alpha-2 billing region code of the user at the time the product was granted.
	RegionCode string `json:"regionCode"`

	// Quantity - If not present, the quantity is 1.
	Quantity int `json:"quantity"`
}

type GooglePurchaseValidateParam

type GooglePurchaseValidateParam struct {
	PackageName   string
	ProductID     string
	PurchaseToken string
}

type GooglePurchaseValidateResponseError

type GooglePurchaseValidateResponseError struct {
	Error struct {
		Code    int    `json:"code"`
		Message string `json:"message"`
		Status  string `json:"status"`
	} `json:"error"`
}

type GoogleSubscriptionsPurchaseResponse

type GoogleSubscriptionsPurchaseResponse struct {
	Kind string `json:"kind"`

	// ISO 3166-1 alpha-2 billing country/region code of the user at the time the subscription was granted.
	RegionCode string `json:"regionCode"`

	// Time at which the subscription was granted. Not set for pending subscriptions (subscription was created but awaiting payment during signup).
	// Timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
	StartTime time.Time `json:"startTime"`

	/*
		Subscription State
		- SUBSCRIPTION_STATE_UNSPECIFIED
		- SUBSCRIPTION_STATE_PENDING
		- SUBSCRIPTION_STATE_ACTIVE
		- SUBSCRIPTION_STATE_PAUSED
		- SUBSCRIPTION_STATE_IN_GRACE_PERIOD
		- SUBSCRIPTION_STATE_ON_HOLD
		- SUBSCRIPTION_STATE_CANCELED
		- SUBSCRIPTION_STATE_EXPIRED
	*/
	SubscriptionState    string  `json:"subscriptionState"`
	LatestOrderID        string  `json:"latestOrderId"`
	AcknowledgementState string  `json:"acknowledgementState"`
	LinkedPurchaseToken  *string `json:"linkedPurchaseToken"`

	LineItems []SubscriptionPurchaseLineItem `json:"lineItems"`

	// Additional context around paused subscriptions. Only present if the subscription currently has subscriptionState SUBSCRIPTION_STATE_PAUSED.
	PausedStateContext   *SubscriptionPausedStateContext   `json:"pausedStateContext"`
	CanceledStateContext *SubscriptionCanceledStateContext `json:"canceledStateContext"`
}

type GoogleSubscriptionsPurchaseValidateParam

type GoogleSubscriptionsPurchaseValidateParam struct {
	PackageName   string
	PurchaseToken string
}

type SubscriptionCanceledStateContext

type SubscriptionCanceledStateContext struct {
	UserInitiatedCancellation *SubscriptionUserInitiatedCancellation `json:"userInitiatedCancellation"`
}

type SubscriptionPausedStateContext

type SubscriptionPausedStateContext struct {
	AutoResumeTime *time.Time `json:"autoResumeTime"`
}

type SubscriptionPurchaseLineItem

type SubscriptionPurchaseLineItem struct {
	ProductId        string                                        `json:"productId"`
	ExpiryTime       time.Time                                     `json:"expiryTime"`
	AutoRenewingPlan *SubscriptionPurchaseLineItemAutoRenewingPlan `json:"autoRenewingPlan"`
	PrepaidPlan      *SubscriptionPurchaseLineItemPrepaidPlan      `json:"prepaidPlan"`
	OfferDetails     *SubscriptionPurchaseLineItemOfferDetails     `json:"offerDetails"`
}

type SubscriptionPurchaseLineItemAutoRenewingPlan

type SubscriptionPurchaseLineItemAutoRenewingPlan struct {
	AutoRenewEnabled *bool `json:"autoRenewEnabled"`
}

type SubscriptionPurchaseLineItemOfferDetails

type SubscriptionPurchaseLineItemOfferDetails struct {
	OfferTags  *[]string `json:"offerTags"`
	BasePlanId *string   `json:"basePlanId"`
	OfferID    *string   `json:"offerId"`
}

type SubscriptionPurchaseLineItemPrepaidPlan

type SubscriptionPurchaseLineItemPrepaidPlan struct {
	AllowExtendAfterTime *time.Time `json:"allowExtendAfterTime"`
}

type SubscriptionUserInitiatedCancellation

type SubscriptionUserInitiatedCancellation struct {
	CancelSurveyResult *SubscriptionUserInitiatedCancellationCancelSurveyResult `json:"cancelSurveyResult"`
	CancelTime         *time.Time                                               `json:"cancelTime"`
}

type SubscriptionUserInitiatedCancellationCancelSurveyResult

type SubscriptionUserInitiatedCancellationCancelSurveyResult struct {
	/* Cancellation Reason
	- CANCEL_SURVEY_REASON_UNSPECIFIED
	- CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE
	- CANCEL_SURVEY_REASON_TECHNICAL_ISSUES
	- CANCEL_SURVEY_REASON_COST_RELATED
	- CANCEL_SURVEY_REASON_FOUND_BETTER_APP
	- CANCEL_SURVEY_REASON_OTHERS
	*/
	Reason *string `json:"reason"`

	// Only set for CANCEL_SURVEY_REASON_OTHERS. This is the user's freeform response to the survey.
	ReasonUserInput *string `json:"reasonUserInput"`
}