* $displayvideoService = new Google\Service\DisplayVideo(...); * $sites = $displayvideoService->advertisers_channels_sites; * */ class AdvertisersChannelsSites extends \Google\Service\Resource { /** * Bulk edits sites under a single channel. The operation will delete the sites * provided in BulkEditSitesRequest.deleted_sites and then create the sites * provided in BulkEditSitesRequest.created_sites. (sites.bulkEdit) * * @param string $advertiserId The ID of the advertiser that owns the parent * channel. * @param string $channelId Required. The ID of the parent channel to which the * sites belong. * @param BulkEditSitesRequest $postBody * @param array $optParams Optional parameters. * @return BulkEditSitesResponse * @throws \Google\Service\Exception */ public function bulkEdit($advertiserId, $channelId, BulkEditSitesRequest $postBody, $optParams = []) { $params = ['advertiserId' => $advertiserId, 'channelId' => $channelId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('bulkEdit', [$params], BulkEditSitesResponse::class); } /** * Creates a site in a channel. (sites.create) * * @param string $advertiserId The ID of the advertiser that owns the parent * channel. * @param string $channelId Required. The ID of the parent channel in which the * site will be created. * @param Site $postBody * @param array $optParams Optional parameters. * * @opt_param string partnerId The ID of the partner that owns the parent * channel. * @return Site * @throws \Google\Service\Exception */ public function create($advertiserId, $channelId, Site $postBody, $optParams = []) { $params = ['advertiserId' => $advertiserId, 'channelId' => $channelId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('create', [$params], Site::class); } /** * Deletes a site from a channel. (sites.delete) * * @param string $advertiserId The ID of the advertiser that owns the parent * channel. * @param string $channelId Required. The ID of the parent channel to which the * site belongs. * @param string $urlOrAppId Required. The URL or app ID of the site to delete. * @param array $optParams Optional parameters. * * @opt_param string partnerId The ID of the partner that owns the parent * channel. * @return DisplayvideoEmpty * @throws \Google\Service\Exception */ public function delete($advertiserId, $channelId, $urlOrAppId, $optParams = []) { $params = ['advertiserId' => $advertiserId, 'channelId' => $channelId, 'urlOrAppId' => $urlOrAppId]; $params = array_merge($params, $optParams); return $this->call('delete', [$params], DisplayvideoEmpty::class); } /** * Lists sites in a channel. (sites.listAdvertisersChannelsSites) * * @param string $advertiserId The ID of the advertiser that owns the parent * channel. * @param string $channelId Required. The ID of the parent channel to which the * requested sites belong. * @param array $optParams Optional parameters. * * @opt_param string filter Allows filtering by site fields. Supported syntax: * * Filter expressions for site retrieval can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` * Examples: * All sites for which the URL or app ID contains "google": * `urlOrAppId : "google"` The length of this field should be no more than 500 * characters. Reference our [filter `LIST` requests](/display- * video/api/guides/how-tos/filters) guide for more information. * @opt_param string orderBy Field by which to sort the list. Acceptable values * are: * `urlOrAppId` (default) The default sorting order is ascending. To * specify descending order for a field, a suffix " desc" should be added to the * field name. Example: `urlOrAppId desc`. * @opt_param int pageSize Requested page size. Must be between `1` and `10000`. * If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` * if an invalid value is specified. * @opt_param string pageToken A token identifying a page of results the server * should return. Typically, this is the value of next_page_token returned from * the previous call to `ListSites` method. If not specified, the first page of * results will be returned. * @opt_param string partnerId The ID of the partner that owns the parent * channel. * @return ListSitesResponse * @throws \Google\Service\Exception */ public function listAdvertisersChannelsSites($advertiserId, $channelId, $optParams = []) { $params = ['advertiserId' => $advertiserId, 'channelId' => $channelId]; $params = array_merge($params, $optParams); return $this->call('list', [$params], ListSitesResponse::class); } /** * Replaces all of the sites under a single channel. The operation will replace * the sites under a channel with the sites provided in * ReplaceSitesRequest.new_sites. **This method regularly experiences high * latency.** We recommend [increasing your default timeout](/display- * video/api/guides/best-practices/timeouts#client_library_timeout) to avoid * errors. (sites.replace) * * @param string $advertiserId The ID of the advertiser that owns the parent * channel. * @param string $channelId Required. The ID of the parent channel whose sites * will be replaced. * @param ReplaceSitesRequest $postBody * @param array $optParams Optional parameters. * @return ReplaceSitesResponse * @throws \Google\Service\Exception */ public function replace($advertiserId, $channelId, ReplaceSitesRequest $postBody, $optParams = []) { $params = ['advertiserId' => $advertiserId, 'channelId' => $channelId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('replace', [$params], ReplaceSitesResponse::class); } } // Adding a class alias for backwards compatibility with the previous class name. class_alias(AdvertisersChannelsSites::class, 'Google_Service_DisplayVideo_Resource_AdvertisersChannelsSites');