Berikut adalah contoh cara membuat iklan display yang diupload:
Java
// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package com.google.ads.googleads.examples.advancedoperations; import com.beust.jcommander.Parameter; import com.google.ads.googleads.examples.utils.ArgumentNames; import com.google.ads.googleads.examples.utils.CodeSampleParams; import com.google.ads.googleads.lib.GoogleAdsClient; import com.google.ads.googleads.v25.common.AdMediaBundleAsset; import com.google.ads.googleads.v25.common.DisplayUploadAdInfo; import com.google.ads.googleads.v25.common.MediaBundleAsset; import com.google.ads.googleads.v25.enums.AdGroupAdStatusEnum.AdGroupAdStatus; import com.google.ads.googleads.v25.enums.AssetTypeEnum.AssetType; import com.google.ads.googleads.v25.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType; import com.google.ads.googleads.v25.errors.GoogleAdsError; import com.google.ads.googleads.v25.errors.GoogleAdsException; import com.google.ads.googleads.v25.resources.Ad; import com.google.ads.googleads.v25.resources.AdGroupAd; import com.google.ads.googleads.v25.resources.Asset; import com.google.ads.googleads.v25.services.AdGroupAdOperation; import com.google.ads.googleads.v25.services.AdGroupAdServiceClient; import com.google.ads.googleads.v25.services.AssetOperation; import com.google.ads.googleads.v25.services.AssetServiceClient; import com.google.ads.googleads.v25.services.MutateAdGroupAdsResponse; import com.google.ads.googleads.v25.services.MutateAssetsResponse; import com.google.ads.googleads.v25.utils.ResourceNames; import com.google.common.collect.ImmutableList; import com.google.common.io.ByteStreams; import com.google.protobuf.ByteString; import java.io.FileNotFoundException; import java.io.IOException; import java.net.URL; /** Adds a display upload ad to a given ad group. To get ad groups, run GetAdGroups.java. */ public class AddDisplayUploadAd { private static final String BUNDLE_URL = "https://gaagl.page.link/ib87"; private static class AddDisplayUploadAdParams extends CodeSampleParams { @Parameter(names = ArgumentNames.CUSTOMER_ID, required = true) private Long customerId; @Parameter(names = ArgumentNames.AD_GROUP_ID, required = true) private Long adGroupId; } public static void main(String[] args) throws IOException { AddDisplayUploadAdParams params = new AddDisplayUploadAdParams(); if (!params.parseArguments(args)) { // Either pass the required parameters for this example on the command line, or insert them // into the code here. See the parameter class definition above for descriptions. params.customerId = Long.parseLong("INSERT_CUSTOMER_ID_HERE"); params.adGroupId = Long.parseLong("INSERT_AD_GROUP_ID_HERE"); } GoogleAdsClient googleAdsClient = null; try { googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build(); } catch (FileNotFoundException fnfe) { System.err.printf( "Failed to load GoogleAdsClient configuration from file. Exception: %s%n", fnfe); System.exit(1); } catch (IOException ioe) { System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe); System.exit(1); } try { new AddDisplayUploadAd().runExample(googleAdsClient, params.customerId, params.adGroupId); } catch (GoogleAdsException gae) { // GoogleAdsException is the base class for most exceptions thrown by an API request. // Instances of this exception have a message and a GoogleAdsFailure that contains a // collection of GoogleAdsErrors that indicate the underlying causes of the // GoogleAdsException. System.err.printf( "Request ID %s failed due to GoogleAdsException. Underlying errors:%n", gae.getRequestId()); int i = 0; for (GoogleAdsError googleAdsError : gae.getGoogleAdsFailure().getErrorsList()) { System.err.printf(" Error %d: %s%n", i++, googleAdsError); } System.exit(1); } } /** * Runs the example. * * @param googleAdsClient the Google Ads API client. * @param customerId the client customer ID. * @param adGroupId the ad group ID. * @throws GoogleAdsException if an API request failed with one or more service errors. */ private void runExample(GoogleAdsClient googleAdsClient, long customerId, long adGroupId) throws IOException { // There are several types of display upload ads. For this example, we will create // an HTML5 upload ad, which requires a media bundle. // The DisplayUploadProductType field lists the available display upload types: // https://developers.google.com/google-ads/api/reference/rpc/v4/DisplayUploadAdInfo // Creates a new media bundle asset and returns the resource name. String adAssetResourceName = createMediaBundleAsset(googleAdsClient, customerId); // Creates a new display upload ad and associates it with the specified ad group. createDisplayUploadAdGroupAd(googleAdsClient, customerId, adGroupId, adAssetResourceName); } /** * Creates a media bundle from the assets in a zip file. The zip file contains the HTML5 * components. * * @param googleAdsClient the Google Ads API client. * @param customerId the client customer ID. * @return the resource name of the newly created media bundle. * @throws IOException if there is an error reading the media bundle. */ private String createMediaBundleAsset(GoogleAdsClient googleAdsClient, long customerId) throws IOException { // The HTML5 zip file contains all the HTML, CSS, and images needed for the // HTML5 ad. For help on creating an HTML5 zip file, check out Google Web // Designer (https://www.google.com/webdesigner/). // // There are several types of display upload ads. For this example, we will create // an HTML5 upload ad, which requires a media bundle. // The DisplayUploadProductType field lists the available display upload types: // https://developers.google.com/google-ads/api/reference/rpc/latest/DisplayUploadAdInfo byte[] html5Zip = ByteStreams.toByteArray(new URL(BUNDLE_URL).openStream()); // Creates the media bundle asset. Asset asset = Asset.newBuilder() .setName("Ad Media Bundle") .setType(AssetType.MEDIA_BUNDLE) .setMediaBundleAsset( MediaBundleAsset.newBuilder().setData(ByteString.copyFrom(html5Zip)).build()) .build(); // Creates the asset operation. AssetOperation operation = AssetOperation.newBuilder().setCreate(asset).build(); // Gets the AssetService. try (AssetServiceClient assetServiceClient = googleAdsClient.getLatestVersion().createAssetServiceClient()) { // Adds the asset to the client account. MutateAssetsResponse response = assetServiceClient.mutateAssets(Long.toString(customerId), ImmutableList.of(operation)); // Displays and returns the resulting resource name. String uploadedAssetResourceName = response.getResults(0).getResourceName(); System.out.printf( "Uploaded media bundle with resource name: '%s'.%n", uploadedAssetResourceName); return uploadedAssetResourceName; } } /** * Creates a new HTML5 display upload ad and adds it to the specified ad group. * * @param googleAdsClient the Google Ads API client. * @param customerId the client customer ID. * @param adGroupId the ad group ID. * @param adAssetResourceName The ID of the ad group to which the new ad will be added. */ private void createDisplayUploadAdGroupAd( GoogleAdsClient googleAdsClient, long customerId, long adGroupId, String adAssetResourceName) { // Creates the ad with the required fields. Ad displayUploadAd = Ad.newBuilder() .setName("Ad for HTML5") .addFinalUrls("http://example.com/html5") // Exactly one ad data field must be included to specify the ad type. See // https://developers.google.com/google-ads/api/reference/rpc/v4/Ad for the full // list of available types. .setDisplayUploadAd( DisplayUploadAdInfo.newBuilder() .setDisplayUploadProductType(DisplayUploadProductType.HTML5_UPLOAD_AD) .setMediaBundle( AdMediaBundleAsset.newBuilder().setAsset(adAssetResourceName).build()) .build()) .build(); // Creates an ad group ad for the new ad. AdGroupAd adGroupAd = AdGroupAd.newBuilder() .setAd(displayUploadAd) .setStatus(AdGroupAdStatus.PAUSED) .setAdGroup(ResourceNames.adGroup(customerId, adGroupId)) .build(); // Creates the ad group ad operation. AdGroupAdOperation operation = AdGroupAdOperation.newBuilder().setCreate(adGroupAd).build(); // Creates the ad group ad service client. try (AdGroupAdServiceClient adGroupAdServiceClient = googleAdsClient.getLatestVersion().createAdGroupAdServiceClient()) { // Adds the ad group ad to the client account. MutateAdGroupAdsResponse response = adGroupAdServiceClient.mutateAdGroupAds( Long.toString(customerId), ImmutableList.of(operation)); // Displays the resulting ad group ad's resource name. System.out.printf( "Created new ad group ad with resource name: '%s'.%n", response.getResults(0).getResourceName()); } } }
C#
// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. using CommandLine; using Google.Ads.Gax.Examples; using Google.Ads.Gax.Util; using Google.Ads.GoogleAds.Lib; using Google.Ads.GoogleAds.Util; using Google.Ads.GoogleAds.V25.Common; using Google.Ads.GoogleAds.V25.Enums; using Google.Ads.GoogleAds.V25.Errors; using Google.Ads.GoogleAds.V25.Resources; using Google.Ads.GoogleAds.V25.Services; using Google.Protobuf; using System; using System.Collections.Generic; using System.Linq; using static Google.Ads.GoogleAds.V25.Enums.DisplayUploadProductTypeEnum.Types; namespace Google.Ads.GoogleAds.Examples.V25 { /// <summary> /// This code example adds a display upload ad to a given ad group. To get ad groups, /// run GetAdGroups.cs. /// </summary> public class AddDisplayUploadAd : ExampleBase { /// <summary> /// Command line options for running the <see cref="AddDisplayUploadAd"/> example. /// </summary> public class Options : OptionsBase { /// <summary> /// The Google Ads customer ID for which the call is made. /// </summary> [Option("customerId", Required = true, HelpText = "The Google Ads customer ID for which the call is made.")] public long CustomerId { get; set; } /// <summary> /// The ID of the ad group to which the new ad will be added. /// </summary> [Option("adGroupId", Required = true, HelpText = "The ID of the ad group to which the new ad will be added.")] public long AdGroupId { get; set; } } /// <summary> /// Main method, to run this code example as a standalone application. /// </summary> /// <param name="args">The command line arguments.</param> public static void Main(string[] args) { Options options = ExampleUtilities.ParseCommandLine<Options>(args); AddDisplayUploadAd codeExample = new AddDisplayUploadAd(); Console.WriteLine(codeExample.Description); codeExample.Run(new GoogleAdsClient(), options.CustomerId, options.AdGroupId); } /// <summary> /// Returns a description about the code example. /// </summary> public override string Description => "This code example adds a display upload ad to a given ad group. To get ad groups, " + "run GetAdGroups.cs."; /// <summary> /// Runs the code example. /// </summary> /// <param name="client">The Google Ads client.</param> /// <param name="customerId">The Google Ads customer ID for which the call is made.</param> /// <param name="adGroupId">The ID of the ad group to which the new ad will be /// added.</param> public void Run(GoogleAdsClient client, long customerId, long adGroupId) { try { // There are several types of display upload ads. For this example, we will create // an HTML5 upload ad, which requires a media bundle. // This feature is only available to allowlisted accounts. // See https://support.google.com/google-ads/answer/1722096 for more details. // The DisplayUploadProductType field lists the available display upload types: // https://developers.google.com/google-ads/api/reference/rpc/latest/DisplayUploadAdInfo // Creates a new media bundle asset and returns the resource name. string adAssetResourceName = CreateMediaBundleAsset(client, customerId); // Creates a new display upload ad and associates it with the specified ad group. CreateDisplayUploadAdGroupAd(client, customerId, adGroupId, adAssetResourceName); } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } } /// <summary> /// Creates a media bundle from the assets in a zip file. The zip file contains the /// HTML5 components. /// </summary> /// <param name="client">The Google Ads API client.</param> /// <param name="customerId">The Google Ads customer ID for which the call is made.</param> /// <returns>The string resource name of the newly uploaded media bundle.</returns> private string CreateMediaBundleAsset(GoogleAdsClient client, long customerId) { // Gets the AssetService. AssetServiceClient assetServiceClient = client.GetService(Services.V25.AssetService); // The HTML5 zip file contains all the HTML, CSS, and images needed for the // HTML5 ad. For help on creating an HTML5 zip file, check out Google Web // Designer (https://www.google.com/webdesigner/). byte[] html5Zip = MediaUtilities.GetAssetDataFromUrl("https://gaagl.page.link/ib87", client.Config); // Creates the media bundle asset. Asset mediaBundleAsset = new Asset() { Type = AssetTypeEnum.Types.AssetType.MediaBundle, MediaBundleAsset = new MediaBundleAsset() { Data = ByteString.CopyFrom(html5Zip) }, Name = "Ad Media Bundle" }; // Creates the asset operation. AssetOperation operation = new AssetOperation() { Create = mediaBundleAsset }; // Adds the asset to the client account. MutateAssetsResponse response = assetServiceClient.MutateAssets(customerId.ToString(), new[] { operation }); // Displays the resulting resource name. string uploadedAssetResourceName = response.Results.First().ResourceName; Console.WriteLine($"Uploaded media bundle: {uploadedAssetResourceName}"); return uploadedAssetResourceName; } /// <summary> /// Creates a new HTML5 display upload ad and adds it to the specified ad group. /// </summary> /// <param name="client">The Google Ads API client.</param> /// <param name="customerId">The Google Ads customer ID for which the call is made.</param> /// <param name="adGroupId">The ID of the ad group to which the new ad will be /// added.</param> /// <param name="adAssetResourceName">The resource name of the media bundle containing /// the HTML5 components.</param> private void CreateDisplayUploadAdGroupAd(GoogleAdsClient client, long customerId, long adGroupId, string adAssetResourceName) { // Get the AdGroupAdService. AdGroupAdServiceClient adGroupAdServiceClient = client.GetService(Services.V25.AdGroupAdService); // Creates the ad with the required fields. Ad displayUploadAd = new Ad() { Name = "Ad for HTML5", FinalUrls = { "http://example.com/html5" }, // Exactly one ad data field must be included to specify the ad type. See // https://developers.google.com/google-ads/api/reference/rpc/latest/Ad for the // full list of available types. DisplayUploadAd = new DisplayUploadAdInfo() { DisplayUploadProductType = DisplayUploadProductType.Html5UploadAd, MediaBundle = new AdMediaBundleAsset() { Asset = adAssetResourceName } } }; // Creates an ad group ad for the new ad. AdGroupAd adGroupAd = new AdGroupAd() { Ad = displayUploadAd, Status = AdGroupAdStatusEnum.Types.AdGroupAdStatus.Paused, AdGroup = ResourceNames.AdGroup(customerId, adGroupId), }; // Creates the ad group ad operation. AdGroupAdOperation operation = new AdGroupAdOperation() { Create = adGroupAd }; // Adds the ad group ad to the client account. MutateAdGroupAdsResponse response = adGroupAdServiceClient.MutateAdGroupAds (customerId.ToString(), new[] { operation }); // Displays the resulting ad group ad's resource name. Console.WriteLine($"Created new ad group ad{response.Results.First().ResourceName}."); } } }
PHP
<?php /** * Copyright 2020 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ namespace Google\Ads\GoogleAds\Examples\AdvancedOperations; require __DIR__ . '/../../vendor/autoload.php'; use GetOpt\GetOpt; use Google\Ads\GoogleAds\Examples\Utils\ArgumentNames; use Google\Ads\GoogleAds\Examples\Utils\ArgumentParser; use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder; use Google\Ads\GoogleAds\Lib\V25\GoogleAdsClient; use Google\Ads\GoogleAds\Lib\V25\GoogleAdsClientBuilder; use Google\Ads\GoogleAds\Lib\V25\GoogleAdsException; use Google\Ads\GoogleAds\Util\V25\ResourceNames; use Google\Ads\GoogleAds\V25\Common\AdMediaBundleAsset; use Google\Ads\GoogleAds\V25\Common\DisplayUploadAdInfo; use Google\Ads\GoogleAds\V25\Common\MediaBundleAsset; use Google\Ads\GoogleAds\V25\Enums\AdGroupAdStatusEnum\AdGroupAdStatus; use Google\Ads\GoogleAds\V25\Enums\AssetTypeEnum\AssetType; use Google\Ads\GoogleAds\V25\Enums\DisplayUploadProductTypeEnum\DisplayUploadProductType; use Google\Ads\GoogleAds\V25\Errors\GoogleAdsError; use Google\Ads\GoogleAds\V25\Resources\Ad; use Google\Ads\GoogleAds\V25\Resources\AdGroupAd; use Google\Ads\GoogleAds\V25\Resources\Asset; use Google\Ads\GoogleAds\V25\Services\AdGroupAdOperation; use Google\Ads\GoogleAds\V25\Services\AssetOperation; use Google\Ads\GoogleAds\V25\Services\MutateAdGroupAdsRequest; use Google\Ads\GoogleAds\V25\Services\MutateAdGroupAdsResponse; use Google\Ads\GoogleAds\V25\Services\MutateAssetsRequest; use Google\ApiCore\ApiException; /** * This code example adds a display upload ad to a given ad group. * To get ad groups, run GetAdGroups.php. */ class AddDisplayUploadAd { private const CUSTOMER_ID = 'INSERT_CUSTOMER_ID_HERE'; private const AD_GROUP_ID = 'INSERT_AD_GROUP_ID_HERE'; public static function main() { // Either pass the required parameters for this example on the command line, or insert them // into the constants above. $options = (new ArgumentParser())->parseCommandArguments( [ ArgumentNames::CUSTOMER_ID => GetOpt::REQUIRED_ARGUMENT, ArgumentNames::AD_GROUP_ID => GetOpt::REQUIRED_ARGUMENT ] ); // Generate a refreshable OAuth2 credential for authentication. $oAuth2Credential = (new OAuth2TokenBuilder())->fromFile()->build(); // Construct a Google Ads client configured from a properties file and the // OAuth2 credentials above. $googleAdsClient = (new GoogleAdsClientBuilder())->fromFile() ->withOAuth2Credential($oAuth2Credential) ->build(); try { self::runExample( $googleAdsClient, $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID, $options[ArgumentNames::AD_GROUP_ID] ?: self::AD_GROUP_ID ); } catch (GoogleAdsException $googleAdsException) { printf( "Request with ID '%s' has failed.%sGoogle Ads failure details:%s", $googleAdsException->getRequestId(), PHP_EOL, PHP_EOL ); foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { /** * @var GoogleAdsError $error */ printf( "\t%s: %s%s", $error->getErrorCode()->getErrorCode(), $error->getMessage(), PHP_EOL ); } exit(1); } catch (ApiException $apiException) { printf( "ApiException was thrown with message '%s'.%s", $apiException->getMessage(), PHP_EOL ); exit(1); } } /** * Runs the example. * * @param GoogleAdsClient $googleAdsClient the Google Ads API client * @param int $customerId the customer ID * @param int $adGroupId the ad group ID to add a display upload ad to */ public static function runExample( GoogleAdsClient $googleAdsClient, int $customerId, int $adGroupId ) { // There are several types of display upload ads. For this example, we will create // an HTML5 upload ad, which requires a media bundle. // The DisplayUploadProductType field lists the available display upload types: // https://developers.google.com/google-ads/api/reference/rpc/latest/DisplayUploadAdInfo // Creates a new media bundle asset and returns the resource name. $adAssetResourceName = self::createMediaBundleAsset($googleAdsClient, $customerId); // Creates a new display upload ad and associates it with the specified ad group. self::createDisplayUploadAdGroupAd( $googleAdsClient, $customerId, $adGroupId, $adAssetResourceName ); } /** * Creates a media bundle from the assets in a zip file. The zip file contains the HTML5 * components. * * @param GoogleAdsClient $googleAdsClient the Google Ads API client * @param int $customerId the customer ID * @return string the resource name of the newly uploaded media bundle asset */ private static function createMediaBundleAsset( GoogleAdsClient $googleAdsClient, int $customerId ) { // The HTML5 zip file contains all the HTML, CSS, and images needed for the // HTML5 ad. For help on creating an HTML5 zip file, check out Google Web // Designer (https://www.google.com/webdesigner/). $html5Zip = file_get_contents('https://gaagl.page.link/ib87'); // Creates the media bundle asset. $asset = new Asset( [ 'name' => 'Ad Media Bundle', 'type' => AssetType::MEDIA_BUNDLE, 'media_bundle_asset' => new MediaBundleAsset(['data' => $html5Zip]) ] ); // Creates an asset operation. $assetOperation = new AssetOperation(); $assetOperation->setCreate($asset); // Issues a mutate request to add the asset. $assetServiceClient = $googleAdsClient->getAssetServiceClient(); $response = $assetServiceClient->mutateAssets( MutateAssetsRequest::build($customerId, [$assetOperation]) ); // Prints the resource name of the added media bundle asset. $addedMediaBundleAssetResourceName = $response->getResults()[0]->getResourceName(); printf( "Uploaded media bundle asset with resource name: '%s'.%s", $addedMediaBundleAssetResourceName, PHP_EOL ); return $addedMediaBundleAssetResourceName;