Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Upload video

YouTubeVideoUploadService memungkinkan Anda mengupload video langsung ke YouTube melalui Google Ads API. Video ini kemudian dapat digunakan untuk membuat aset video dalam berbagai jenis iklan, seperti kampanye Performa Maksimal atau kampanye Peningkat Permintaan.

Layanan ini menyederhanakan alur kerja pembuatan iklan video dengan menangani proses upload YouTube, sehingga memastikan video dikaitkan dengan benar ke akun Anda.

Konsep utama

Sebelum memulai, Anda perlu memahami cara pengelolaan upload video dan berbagai status yang dapat dilalui.

Alur kerja menyeluruh

Mengupload file video dan menayangkannya dalam iklan memerlukan empat langkah berurutan:

Langkah	Layanan dan metode	Ringkasan
1. Memulai dan mengupload byte video	`CreateYouTubeVideoUpload` pada `YouTubeVideoUploadService`	Upload metadata video dan file biner untuk membuat resource `YouTubeVideoUpload` (`customers/{customer_id}/youTubeVideoUploads/{video_upload_id}`).
2. Status pemrosesan polling	`SearchStream` pada `GoogleAdsService`	Kueri `you_tube_video_upload` hingga `state = 'PROCESSED'` dan `video_id` YouTube 11 karakter akan diisi.
3. Membuat aset video yang dapat digunakan kembali	`MutateAssets` pada `AssetService`	Buat `YoutubeVideoAsset` (`youtube_video_id = video_id`) untuk mendapatkan nama resource aset (`customers/{customer_id}/assets/{asset_id}`).
4. Menautkan aset ke kampanye atau iklan	`MutateAssetGroupAssets` pada `AssetGroupAssetService`, atau `MutateAdGroupAds` pada `AdGroupAdService`	Tautkan aset ke `AssetGroupAsset` (`field_type = YOUTUBE_VIDEO`) Performa Maksimal atau `DemandGenVideoResponsiveAdInfo` (`videos[].asset`) Peningkat Permintaan.

Kepemilikan channel

Saat mengupload video, Anda dapat menentukan channel YouTube tujuan menggunakan kolom channel_id di resource YouTubeVideoUpload:

Channel milik pengiklan (merek): Berikan channel_id channel YouTube yang sudah ada milik pengiklan. Hal ini hanya didukung dengan alur autentikasi pengguna; tidak dapat digunakan dengan akun layanan.
Channel yang dikelola Google: Jika channel_id dihilangkan, video akan diupload ke channel YouTube yang dikelola Google yang terkait dengan akun Google Ads.

Status upload

Siklus proses upload video YouTube dilacak oleh kolom state. Enum YouTubeVideoUploadState menentukan status berikut:

Negara Bagian	Deskripsi
`PENDING`	Video sedang diupload.
`UPLOADED`	Video telah berhasil diupload dan sedang diproses oleh YouTube.
`PROCESSED`	Video telah berhasil diproses dan siap digunakan.
`FAILED`	Upload atau pemrosesan gagal dan tidak dapat diselesaikan.
`REJECTED`	Video ditolak karena alasan validasi atau kebijakan.
`UNAVAILABLE`	Status video tidak tersedia; video mungkin telah dihapus dari YouTube.

Setelan privasi

Kolom video_privacy mengontrol siapa yang dapat melihat video yang diupload. Enum YouTubeVideoPrivacy mendukung:

PUBLIC: Video tersedia untuk siapa saja di YouTube. (Hanya diizinkan untuk channel korporat).
UNLISTED: Video tidak dapat ditelusuri, tetapi dapat dilihat oleh siapa saja yang memiliki link. Ini adalah opsi default dan satu-satunya opsi untuk saluran yang dikelola Google.

Persyaratan judul dan deskripsi

Saat membuat upload video, Anda dapat menentukan metadata menggunakan kolom video_title dan video_description di resource YouTubeVideoUpload:

video_title: Wajib diisi. Judul tidak boleh melebihi 100 karakter dan tidak boleh berisi karakter yang tidak valid (tanda kurung sudut < atau >). Judul hanya dapat ditetapkan saat membuat upload video dan tidak dapat diubah setelah dibuat.
video_description: Opsional. Deskripsi tidak boleh melebihi 5.000 karakter dan tidak boleh berisi karakter yang tidak valid (tanda kurung sudut < atau >). Deskripsi hanya dapat ditetapkan saat membuat upload video dan tidak dapat diubah setelah dibuat.

Kedua kolom tidak dapat diubah setelah dibuat. Menyertakan video_title atau video_description dalam mask update permintaan UpdateYouTubeVideoUpload akan gagal dengan error FieldError.IMMUTABLE_FIELD.

Untuk mengetahui informasi selengkapnya tentang pemformatan judul dan deskripsi YouTube serta karakter yang tidak valid, lihat Pusat Bantuan YouTube.

Pengungkapan konten generatif

Mulai v26, berdasarkan peraturan seperti EU AI Act, pengiklan dapat mengungkapkan apakah konten video yang diupload berisi media buatan AI atau media sintetis.

Kolom video_content_metadata di YouTubeVideoUpload berisi VideoContentMetadata. Tetapkan kolom generative_content_disclosure bertingkatnya menggunakan enum YouTubeVideoUploadGenerativeContentDisclosure:

Nilai	Deskripsi
`NON_GENERATIVE_CONTENT`	Pengiklan mengungkapkan bahwa video tersebut tidak dibuat oleh AI.
`GENERATIVE_CONTENT`	Pengiklan mengungkapkan bahwa video tersebut dibuat oleh AI.

Upload video

Untuk mengupload video, Anda harus menggunakan permintaan multibagian ke metode CreateYouTubeVideoUpload. Permintaan tersebut berisi metadata untuk upload dan file video itu sendiri.

1. Memulai upload

Buat CreateYouTubeVideoUploadRequest dengan kolom berikut:

Kolom	Persyaratan	Deskripsi dan batasan
`customer_id`	Wajib	ID pelanggan Google Ads 10 digit (tanpa tanda hubung).
`you_tube_video_upload.video_title`	Wajib (`INPUT_ONLY`, `IMMUTABLE`)	Judul video yang diupload di YouTube (maksimal 100 karakter; tidak boleh berisi `<` atau `>`).
`you_tube_video_upload.video_description`	Opsional (`INPUT_ONLY`, `IMMUTABLE`)	Deskripsi video di YouTube (maksimal 5.000 karakter; tidak boleh berisi `<` atau `>`).
`you_tube_video_upload.channel_id`	Opsional (`IMMUTABLE`)	ID channel YouTube tujuan yang terdiri dari 24 karakter (dimulai dengan `UC`) untuk channel korporat milik pengiklan. Jika dihilangkan, video akan diupload ke channel yang dikelola Google.
`you_tube_video_upload.video_privacy`	Opsional (dapat diubah di channel korporat)	Setelan `YouTubeVideoPrivacy` (default `UNLISTED`, atau `PUBLIC` untuk channel korporat milik pengiklan).
`you_tube_video_upload.video_content_metadata`	Opsional (`INPUT_ONLY`, `IMMUTABLE`)	Tersedia mulai v26: `VideoContentMetadata` dengan `generative_content_disclosure` ditetapkan ke nilai `YouTubeVideoUploadGenerativeContentDisclosure` (`NON_GENERATIVE_CONTENT` atau `GENERATIVE_CONTENT`).

Jika Anda menggunakan library klien, panggil metode CreateYouTubeVideoUpload, teruskan file video Anda, dan upload video akan ditangani secara internal.

Java

String videoUploadResourceName;
try (YouTubeVideoUploadServiceClient youTubeVideoUploadServiceClient =
    googleAdsClient.getLatestVersion().createYouTubeVideoUploadServiceClient()) {
  YouTubeVideoUpload youTubeVideoUpload =
      YouTubeVideoUpload.newBuilder()
          .setVideoTitle("Test Video")
          .setVideoDescription("Test Video Description")
          .setVideoPrivacy(YouTubeVideoPrivacy.UNLISTED)
          .build();

  CreateYouTubeVideoUploadRequest createUploadRequest =
      CreateYouTubeVideoUploadRequest.newBuilder()
          .setCustomerId(Long.toString(customerId))
          .setYouTubeVideoUpload(youTubeVideoUpload)
          .build();

  CreateYouTubeVideoUploadResponse response =
      youTubeVideoUploadServiceClient.createYouTubeVideoUpload(
          createUploadRequest, () -> new FileInputStream(videoFile), null);

  videoUploadResourceName = response.getResourceName();
  System.out.printf("Created YouTube video upload: %s%n", videoUploadResourceName);
}UploadVideo.java

C#

YouTubeVideoUploadServiceClient ytService = client.GetService(
    Services.V26.YouTubeVideoUploadService);

CreateYouTubeVideoUploadRequest createUploadRequest =
    new CreateYouTubeVideoUploadRequest()
    {
        CustomerId = customerId.ToString(),
        YouTubeVideoUpload = new YouTubeVideoUpload()
        {
            VideoTitle = "Test Video",
            VideoDescription = "Test Video Description",
            VideoPrivacy = YouTubeVideoPrivacy.Unlisted
        }
    };

string videoUploadResourceName;
using (FileStream stream = File.OpenRead(videoFilePath))
{
    ResumableUploadSession<CreateYouTubeVideoUploadRequest, CreateYouTubeVideoUploadResponse> session =
        ytService.CreateYouTubeVideoUpload();
    CreateYouTubeVideoUploadResponse response =
        session.BeginUploadAsync(createUploadRequest, stream).Result;

    videoUploadResourceName = response.ResourceName;
    Console.WriteLine($"Created YouTube video upload: {videoUploadResourceName}");
}UploadVideo.cs

PHP

$youTubeVideoUploadServiceClient = $googleAdsClient->getYouTubeVideoUploadServiceClient();

$youTubeVideoUpload = new YouTubeVideoUpload([
    'video_title' => 'Test Video',
    'video_description' => 'Test Video Description',
    'video_privacy' => YouTubeVideoPrivacy::UNLISTED
]);

$createYouTubeVideoUploadRequest = CreateYouTubeVideoUploadRequest::build(
    $customerId,
    $youTubeVideoUpload
);

/** @var ResumableUpload $resumableUpload */
$resumableUpload = $youTubeVideoUploadServiceClient->createYouTubeVideoUpload(
    $createYouTubeVideoUploadRequest
);

$stream = Utils::streamFor(fopen($videoFilePath, 'rb'));
/** @var CreateYouTubeVideoUploadResponse $response */
$response = $resumableUpload->startUpload($stream);

$videoUploadResourceName = $response->getResourceName();
printf("Created YouTube video upload: '%s'%s", $videoUploadResourceName, PHP_EOL);UploadVideo.php

Python

yt_service: YouTubeVideoUploadServiceClient = client.get_service(
    "YouTubeVideoUploadService"
)

create_upload_request: CreateYouTubeVideoUploadRequest = (
    youtube_video_upload_service.CreateYouTubeVideoUploadRequest()
)
create_upload_request.customer_id = customer_id
create_upload_request.you_tube_video_upload.video_title = "Test Video"
create_upload_request.you_tube_video_upload.video_description = (
    "Test Video Description"
)
create_upload_request.you_tube_video_upload.video_privacy = (
    client.enums.YouTubeVideoPrivacyEnum.UNLISTED
)

video_upload_resource_name: str
with open(video_file_path, "rb") as stream:
    response: CreateYouTubeVideoUploadResponse = (
        yt_service.create_you_tube_video_upload(
            stream=stream,
            request=create_upload_request,
            retry=None,
        )
    )
    video_upload_resource_name = response.resource_name
    print(f"Created YouTube video upload: {video_upload_resource_name}")upload_video.py

Ruby

video_upload = client.resource.you_tube_video_upload do |v|
  v.video_title = "Test Video"
  v.video_description = "Test Video Description"
  v.video_privacy = :UNLISTED
end

upload = client.service.you_tube_video_upload.create_you_tube_video_upload(
  customer_id: customer_id,
  you_tube_video_upload: video_upload,
)

video_upload_resource_name = nil
File.open(video_file_path, "rb") do |stream|
  response = upload.start(
    stream: stream,
    content_type: "application/octet-stream",
  )
  video_upload_resource_name = response.resource_name
  puts "Created YouTube video upload: #{video_upload_resource_name}"
endupload_video.rb

Perl

This example is not yet available in Perl; you can take a look at the other languages.

curl

# 
# Use the --i curl parameter to capture response headers in the $RESPONSE
# variable.
FILE_SIZE=$(wc -c < "${VIDEO_FILE_NAME}" | tr -d '\r')
RESPONSE=$(curl -i -f -v -s --request POST \
"https://googleads.googleapis.com/resumable/upload/v${API_VERSION}/customers/${CUSTOMER_ID}/youTubeVideoUploads:create" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Protocol: resumable" \
--header "X-Goog-Upload-Command: start" \
--header "X-Goog-Upload-Header-Content-Length: ${FILE_SIZE}" \
--data @- <<EOF
{
  "customer_id": "${CUSTOMER_ID}",
  "you_tube_video_upload": {
    "video_title": "${VIDEO_TITLE}",
    "video_description": "${VIDEO_DESCRIPTION}",
    "video_privacy": "UNLISTED"
  }
}
EOF
)

# Extract the value of the "x-goog-upload-url" header from the HTTP response.
UPLOAD_URL=$(echo "${RESPONSE}" \
  | grep -i '^x-goog-upload-url' \
  | awk '{print $2}' \
  | tr -d '\r')
CHUNK_SIZE=$(echo "${RESPONSE}" \
  | grep -i '^x-goog-upload-chunk-granularity' \
  | awk '{print $2}' \
  | tr -d '\r')upload_video.sh

Jika Anda menggunakan REST, bagian berikut menjelaskan cara mengelola upload video.

2. Mengupload video

Saat mengupload dengan REST, CreateYouTubeVideoUpload menggunakan protokol upload yang dapat dilanjutkan dua langkah:

Memulai sesi upload: Kirim permintaan POST awal ke endpoint upload CreateYouTubeVideoUpload (/upload/v26/customers/{customer_id}/youTubeVideoUploads:create) dengan x-goog-upload-command: start (dan secara opsional x-goog-upload-header-content-length untuk mendeklarasikan ukuran file). Respons akan menampilkan URL sesi upload di header respons HTTP x-goog-upload-url, beserta metadata seperti ukuran potongan yang diharapkan.
Streaming dan selesaikan byte video: Kirim payload video biner ke endpoint x-goog-upload-url dengan x-goog-upload-command: upload, finalize. Setelah upload selesai, respons akan menampilkan resource_name (customers/{customer_id}/youTubeVideoUploads/{video_upload_id}) yang dibuat.

Untuk deskripsi lengkap header HTTP yang digunakan dalam protokol upload video, lihat contoh kode berikut:

# Take the first ${CHUNK_SIZE} bytes of the video file and upload them.
head -c ${CHUNK_SIZE} ${VIDEO_FILE_NAME} | curl -i -v -X PUT "${UPLOAD_URL}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Offset: 0" \
--header "X-Goog-Upload-Command: upload" \
--header "Content-Length: ${CHUNK_SIZE}" \
--data-binary @-

# Query the status of the upload.
QUERY_RESPONSE=$(curl -i -s -X POST "${UPLOAD_URL}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Command: query")

# Extract the value of the "x-goog-upload-size-received" header from the HTTP
# response.
UPLOADED_BYTES=$(echo "${QUERY_RESPONSE}" \
  | grep -i '^x-goog-upload-size-received' \
  | awk '{print $2}' \
  | tr -d '\r')

echo "Uploaded ${UPLOADED_BYTES} bytes."

REMAINING_BYTES=$((FILE_SIZE - UPLOADED_BYTES))
echo "${REMAINING_BYTES} bytes remaining to upload."

FINALIZE_RESPONSE=$(tail -c ${REMAINING_BYTES} ${VIDEO_FILE_NAME} | curl -v -X PUT "${UPLOAD_URL}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--header "X-Goog-Upload-Offset: ${UPLOADED_BYTES}" \
--header "X-Goog-Upload-Command: upload, finalize" \
--data-binary @-)
UPLOADED_VIDEO_RESOURCE_NAME=$(echo $FINALIZE_RESPONSE | jq -r '.resourceName')upload_video.sh

3. Mengambil status upload video

Setelah memulai upload video, lakukan polling status pemrosesannya dengan mengkueri kolom yang dapat dipilih dari resource you_tube_video_upload (resource_name, video_upload_id, channel_id, video_id, state, dan video_privacy) dengan GAQL hingga state = 'PROCESSED' (kolom INPUT_ONLY tidak dapat dipilih di GAQL):

Java

// Retrieve the metadata of the newly uploaded video.
String query =
    String.format(
        "SELECT "
            + "you_tube_video_upload.resource_name, "
            + "you_tube_video_upload.video_id, "
            + "you_tube_video_upload.state "
            + "FROM you_tube_video_upload "
            + "WHERE you_tube_video_upload.resource_name = '%s'",
        videoUploadResourceName);

try (GoogleAdsServiceClient googleAdsServiceClient =
    googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
  SearchGoogleAdsStreamRequest request =
      SearchGoogleAdsStreamRequest.newBuilder()
          .setCustomerId(Long.toString(customerId))
          .setQuery(query)
          .build();

  ServerStream<SearchGoogleAdsStreamResponse> stream =
      googleAdsServiceClient.searchStreamCallable().call(request);

  for (SearchGoogleAdsStreamResponse response : stream) {
    for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
      YouTubeVideoUpload video = googleAdsRow.getYouTubeVideoUpload();
      System.out.printf(
          "Video with ID %s was found in state %s.%n",
          video.getVideoId(), video.getState());
    }
  }
}UploadVideo.java

C#

// Retrieve the metadata of the newly uploaded video.
string query = $@"
    SELECT
      you_tube_video_upload.resource_name,
      you_tube_video_upload.video_id,
      you_tube_video_upload.state
    FROM you_tube_video_upload
    WHERE you_tube_video_upload.resource_name = '{videoUploadResourceName}'";

GoogleAdsServiceClient gaService = client.GetService(
    Services.V26.GoogleAdsService);

gaService.SearchStream(customerId.ToString(), query,
    delegate (SearchGoogleAdsStreamResponse resp)
    {
        foreach (GoogleAdsRow row in resp.Results)
        {
            Console.WriteLine(
                $"Video with ID {row.YouTubeVideoUpload.VideoId} was found in " +
                $"state {row.YouTubeVideoUpload.State}.");
        }
    }
);UploadVideo.cs

PHP

// Retrieve the metadata of the newly uploaded video.
$query = sprintf(
    "SELECT you_tube_video_upload.resource_name, "
    . "you_tube_video_upload.video_id, "
    . "you_tube_video_upload.state "
    . "FROM you_tube_video_upload "
    . "WHERE you_tube_video_upload.resource_name = '%s'",
    $videoUploadResourceName
);

$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
$stream = $googleAdsServiceClient->searchStream(
    SearchGoogleAdsStreamRequest::build($customerId, $query)
);

foreach ($stream->iterateAllElements() as $googleAdsRow) {
    /** @var GoogleAdsRow $googleAdsRow */
    printf(
        "Video with ID '%s' was found in state '%s'.%s",
        $googleAdsRow->getYouTubeVideoUpload()->getVideoId(),
        YouTubeVideoUploadState::name($googleAdsRow->getYouTubeVideoUpload()->getState()),
        PHP_EOL
    );
}UploadVideo.php

Python

# Retrieve the metadata of the newly uploaded video.
query: str = f"""
    SELECT
      you_tube_video_upload.resource_name,
      you_tube_video_upload.video_id,
      you_tube_video_upload.state
    FROM you_tube_video_upload
    WHERE you_tube_video_upload.resource_name = '{video_upload_resource_name}'"""

ga_service: GoogleAdsServiceClient = client.get_service("GoogleAdsService")
stream: Iterator[SearchGoogleAdsStreamResponse] = ga_service.search_stream(
    customer_id=customer_id, query=query
)

for row in itertools.chain.from_iterable(batch.results for batch in stream):
    video = row.you_tube_video_upload
    print(
        f"Video with ID {row.you_tube_video_upload.video_id} was found in state {row.you_tube_video_upload.state}."
    )upload_video.py

Ruby

# Retrieve the metadata of the newly uploaded video.
query = <<~EOQ
  SELECT
    you_tube_video_upload.resource_name,
    you_tube_video_upload.video_id,
    you_tube_video_upload.state
  FROM you_tube_video_upload
  WHERE you_tube_video_upload.resource_name = '#{video_upload_resource_name}'
EOQ

responses = client.service.google_ads.search_stream(
  customer_id: customer_id,
  query: query,
)

responses.each do |batch|
  batch.results.each do |row|
    puts "Video with ID #{row.you_tube_video_upload.video_id} was found in " \
      "state #{row.you_tube_video_upload.state}."
  end
endupload_video.rb

Perl

This example is not yet available in Perl; you can take a look at the other languages.

curl

curl -i -v -X POST \
"https://qa-prod-googleads.sandbox.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:search" \
--header "Content-Type: application/json" \
  --header "Developer-Token: ${DEVELOPER_TOKEN}" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<EOF
{
  "query": "SELECT you_tube_video_upload.resource_name, you_tube_video_upload.video_id, you_tube_video_upload.state FROM you_tube_video_upload WHERE you_tube_video_upload.resource_name = '$UPLOADED_VIDEO_RESOURCE_NAME'"
}
EOFupload_video.sh

Kelola upload

Setelah upload video selesai, Anda dapat menggunakannya sebagai aset video.

Gunakan video yang diupload

Setelah video mencapai status PROCESSED, Anda dapat menemukan ID video YouTube 11 karakter di kolom video_id pada resource YouTubeVideoUpload.

Gunakan video_id ini untuk membuat YoutubeVideoAsset dengan MutateAssets dan tautkan nama resource aset yang dihasilkan (customers/{customer_id}/assets/{asset_id}) ke kampanye atau iklan Anda:

Buat YoutubeVideoAsset dengan meneruskan youtube_video_id ke AssetService.MutateAssets:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/assets:mutate
{
  "operations": [
    {
      "create": {
        "name": "Product Launch Video",
        "youtubeVideoAsset": {
          "youtubeVideoId": "dQw4w9WgXcQ"
        }
      }
    }
  ]
}

Tautkan Asset ke AssetGroup atau AdGroupAd:

Performa Maksimal: Buat AssetGroupAsset menggunakan AssetGroupAssetService.MutateAssetGroupAssets dengan field_type ditetapkan ke YOUTUBE_VIDEO:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/assetGroupAssets:mutate
{
  "operations": [
    {
      "create": {
        "assetGroup": "customers/{customer_id}/assetGroups/{asset_group_id}",
        "asset": "customers/{customer_id}/assets/{asset_id}",
        "fieldType": "YOUTUBE_VIDEO"
      }
    }
  ]
}

Peningkat Permintaan: Referensikan customers/{customer_id}/assets/{asset_id} dalam daftar videos objek DemandGenVideoResponsiveAdInfo saat memanggil AdGroupAdService.MutateAdGroupAds:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/adGroupAds:mutate
{
  "operations": [
    {
      "create": {
        "adGroup": "customers/{customer_id}/adGroups/{ad_group_id}",
        "status": "PAUSED",
        "ad": {
          "name": "Demand Gen Video Ad",
          "finalUrls": ["https://www.example.com"],
          "demandGenVideoResponsiveAd": {
            "videos": [
              {
                "asset": "customers/{customer_id}/assets/{asset_id}"
              }
            ],
            "logoImages": [
              {
                "asset": "customers/{customer_id}/assets/{logo_asset_id}"
              }
            ],
            "headlines": [
              {
                "text": "Example Headline"
              }
            ],
            "longHeadlines": [
              {
                "text": "Example Long Headline"
              }
            ],
            "descriptions": [
              {
                "text": "Example Description"
              }
            ],
            "businessName": {
              "text": "Example Business"
            }
          }
        }
      }
    }
  ]
}

Buat kueri aset YOUTUBE_VIDEO yang ada menggunakan GoogleAdsService.SearchStream:

SELECT
  asset.id,
  asset.resource_name,
  asset.name,
  asset.type,
  asset.youtube_video_asset.youtube_video_id,
  asset.youtube_video_asset.youtube_video_title
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
  AND asset.youtube_video_asset.youtube_video_id = '{video_id}'

Update metadata

Anda dapat memperbarui setelan privasi video yang diupload melalui API ini menggunakan metode UpdateYouTubeVideoUpload dengan update_mask yang ditetapkan ke "video_privacy". Hanya kolom video_privacy (PUBLIC atau UNLISTED, untuk video yang diupload ke channel korporat milik pengiklan) yang dapat diperbarui setelah pembuatan; video_title, video_description, channel_id, dan video_content_metadata tidak dapat diubah. Menyertakan video_title atau video_description dalam update mask akan gagal dengan error FieldError.IMMUTABLE_FIELD.

Menghapus upload

Jika Anda perlu menghapus video yang diupload dengan Google Ads API, teruskan nama resource customers/{customer_id}/youTubeVideoUploads/{video_upload_id}-nya di kolom resource_names pada metode RemoveYouTubeVideoUpload. Tindakan ini akan menghapus video dari daftar aset Google Ads dan YouTube.

Upload video Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Konsep utama

Alur kerja menyeluruh

Kepemilikan channel

Status upload

Setelan privasi

Persyaratan judul dan deskripsi

Pengungkapan konten generatif

Upload video

1. Memulai upload

Java

C#

PHP

Python

Ruby

Perl

curl

2. Mengupload video

3. Mengambil status upload video

Java

C#

PHP

Python

Ruby

Perl

curl

Kelola upload

Gunakan video yang diupload

Update metadata

Menghapus upload

Upload video