Initialization

Prerequisites

• You have registered an Alibaba Cloud account, completed real-name verification, and activated ApsaraVideo for VOD.
• You have obtained an AccessKey for access to ApsaraVideo for VOD. You can create an AccessKey for your Alibaba Cloud account on the AccessKey management page of the Alibaba Cloud console. Alternatively, you can create a RAM user in the RAM console and grant the user the permission to access ApsaraVideo for VOD. For more information, see RAM user access.

Initialization

The regionId parameter specifies the region of ApsaraVideo for VOD. Set this parameter to cn-shanghai for a region in China.

• Use an AccessKey

package main

import (
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk"
    "github.com/aliyun/alibaba-cloud-sdk-go/services/vod"
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk/auth/credentials"
    "fmt"
)

func InitVodClient(accessKeyId string, accessKeySecret string) (client *vod.Client, err error) {

    // Sets the region of ApsaraVideo for VOD.
    regionId := "cn-shanghai"

    // Creates an authorization object.
    credential := &credentials.AccessKeyCredential{
        accessKeyId,
        accessKeySecret,
    }

    // Customizes the connection configuration.
    config := sdk.NewConfig()
    config.AutoRetry = true // Indicates whether the system automatically retries to connect to ApsaraVideo for VOD upon a connection failure.
    config.MaxRetryTime = 3 // The maximum number of retries allowed.
    config.Timeout = 3000000000 // The connection timeout duration, in nanoseconds. The default value 3000000000 indicates 3 seconds.

    // Creates a vodClient instance.
    return vod.NewClientWithOptions(regionId, config, credential)
}

• Use Security Token Service (STS)

package main

import (
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk"
    "github.com/aliyun/alibaba-cloud-sdk-go/services/vod"
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk/auth/credentials"
    "fmt"
)

func InitVodClient(accessKeyId string, accessKeySecret string, securityToken string) (client *vod.Client, err error) {

    // Sets the region of ApsaraVideo for VOD.
    regionId := "cn-shanghai"

    // Creates an authorization object.
    credential := &credentials.StsTokenCredential{
        accessKeyId,
        accessKeySecret,
        securityToken,
    }

    // Customizes the connection configuration.
    config := sdk.NewConfig()
    config.AutoRetry = true // Indicates whether the system automatically retries to connect to ApsaraVideo for VOD upon a connection failure.
    config.MaxRetryTime = 3 // The maximum number of retries allowed.
    config.Timeout = 3000000000 // The connection timeout duration, in nanoseconds. The default value 3000000000 indicates 3 seconds.

    // Creates a vodClient instance.
    return vod.NewClientWithOptions(regionId, config, credential)
}

Instructions

When calling the vod.Create${apiName}Request method to create an API request, you need to replace ${apiName} with the name of the ApsaraVideo for VOD operation to be called. For more information about available operations, see API overview.

Call example

The following code uses the GetPlayInfo operation as an example:

func MyGetPlayInfo(client *vod.Client, videoId string) (response *vod.GetPlayInfoResponse, err error) {
    // Calls the vod.Create${apiName}Request method to create an API request and sets parameters.
    request := vod.CreateGetPlayInfoRequest()
    request.VideoId = videoId
    request.AcceptFormat = "JSON"

    // Calls client.${apiName}(request) to initiate the request and handle exceptions (if any).
    return client.GetPlayInfo(request)
}

func main() {
    client, err := InitVodClient("<AccessKeyId>", "<AccessKeySecret>")
    if err ! = nil {
        // Handles exceptions (if any).
        panic(err)
    }

    response, err := MyGetPlayInfo(client, "<videoId>")
    if err ! = nil {
        // Handles exceptions (if any).
        panic(err)
    }

    // fmt.Println(response)
    playList := response.PlayInfoList.PlayInfo
    for _, playInfo := range playList {
        // The video definition and playback URL.
        fmt.Printf("%s: %s\n", playInfo.Definition, playInfo.PlayURL)
    }
}

Additional information

• For more information, see Alibaba Cloud SDK: Use Go SDK.
• This SDK supports both concurrent and generic API calls. For more information, see the README file of the SDK.
• To download the sample code, click test_vod.go.