* $adsenseService = new Google\Service\Adsense(...); * $adunits = $adsenseService->accounts_adclients_adunits; * */ class AccountsAdclientsAdunits extends \Google\Service\Resource { /** * Creates an ad unit. This method can be called only by a restricted set of * projects, which are usually owned by [AdSense for * Platforms](https://developers.google.com/adsense/platforms/) publishers. * Contact your account manager if you need to use this method. Note that ad * units can only be created for ad clients with an "AFC" product code. For more * info see the [AdClient * resource](/adsense/management/reference/rest/v2/accounts.adclients). For now, * this method can only be used to create `DISPLAY` ad units. See: * https://support.google.com/adsense/answer/9183566 (adunits.create) * * @param string $parent Required. Ad client to create an ad unit under. Format: * accounts/{account}/adclients/{adclient} * @param AdUnit $postBody * @param array $optParams Optional parameters. * @return AdUnit * @throws \Google\Service\Exception */ public function create($parent, AdUnit $postBody, $optParams = []) { $params = ['parent' => $parent, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('create', [$params], AdUnit::class); } /** * Gets an ad unit from a specified account and ad client. (adunits.get) * * @param string $name Required. AdUnit to get information about. Format: * accounts/{account}/adclients/{adclient}/adunits/{adunit} * @param array $optParams Optional parameters. * @return AdUnit * @throws \Google\Service\Exception */ public function get($name, $optParams = []) { $params = ['name' => $name]; $params = array_merge($params, $optParams); return $this->call('get', [$params], AdUnit::class); } /** * Gets the ad unit code for a given ad unit. For more information, see [About * the AdSense code](https://support.google.com/adsense/answer/9274634) and * [Where to place the ad code in your * HTML](https://support.google.com/adsense/answer/9190028). (adunits.getAdcode) * * @param string $name Required. Name of the adunit for which to get the adcode. * Format: accounts/{account}/adclients/{adclient}/adunits/{adunit} * @param array $optParams Optional parameters. * @return AdUnitAdCode * @throws \Google\Service\Exception */ public function getAdcode($name, $optParams = []) { $params = ['name' => $name]; $params = array_merge($params, $optParams); return $this->call('getAdcode', [$params], AdUnitAdCode::class); } /** * Lists all ad units under a specified account and ad client. * (adunits.listAccountsAdclientsAdunits) * * @param string $parent Required. The ad client which owns the collection of ad * units. Format: accounts/{account}/adclients/{adclient} * @param array $optParams Optional parameters. * * @opt_param int pageSize The maximum number of ad units to include in the * response, used for paging. If unspecified, at most 10000 ad units will be * returned. The maximum value is 10000; values above 10000 will be coerced to * 10000. * @opt_param string pageToken A page token, received from a previous * `ListAdUnits` call. Provide this to retrieve the subsequent page. When * paginating, all other parameters provided to `ListAdUnits` must match the * call that provided the page token. * @return ListAdUnitsResponse * @throws \Google\Service\Exception */ public function listAccountsAdclientsAdunits($parent, $optParams = []) { $params = ['parent' => $parent]; $params = array_merge($params, $optParams); return $this->call('list', [$params], ListAdUnitsResponse::class); } /** * Lists all the custom channels available for an ad unit. * (adunits.listLinkedCustomChannels) * * @param string $parent Required. The ad unit which owns the collection of * custom channels. Format: * accounts/{account}/adclients/{adclient}/adunits/{adunit} * @param array $optParams Optional parameters. * * @opt_param int pageSize The maximum number of custom channels to include in * the response, used for paging. If unspecified, at most 10000 custom channels * will be returned. The maximum value is 10000; values above 10000 will be * coerced to 10000. * @opt_param string pageToken A page token, received from a previous * `ListLinkedCustomChannels` call. Provide this to retrieve the subsequent * page. When paginating, all other parameters provided to * `ListLinkedCustomChannels` must match the call that provided the page token. * @return ListLinkedCustomChannelsResponse * @throws \Google\Service\Exception */ public function listLinkedCustomChannels($parent, $optParams = []) { $params = ['parent' => $parent]; $params = array_merge($params, $optParams); return $this->call('listLinkedCustomChannels', [$params], ListLinkedCustomChannelsResponse::class); } /** * Updates an ad unit. This method can be called only by a restricted set of * projects, which are usually owned by [AdSense for * Platforms](https://developers.google.com/adsense/platforms/) publishers. * Contact your account manager if you need to use this method. For now, this * method can only be used to update `DISPLAY` ad units. See: * https://support.google.com/adsense/answer/9183566 (adunits.patch) * * @param string $name Output only. Resource name of the ad unit. Format: * accounts/{account}/adclients/{adclient}/adunits/{adunit} * @param AdUnit $postBody * @param array $optParams Optional parameters. * * @opt_param string updateMask The list of fields to update. If empty, a full * update is performed. * @return AdUnit * @throws \Google\Service\Exception */ public function patch($name, AdUnit $postBody, $optParams = []) { $params = ['name' => $name, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('patch', [$params], AdUnit::class); } } // Adding a class alias for backwards compatibility with the previous class name. class_alias(AccountsAdclientsAdunits::class, 'Google_Service_Adsense_Resource_AccountsAdclientsAdunits');