<?php

/*
 * Copyright 2014 Google Inc.
 *
 * 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.
 */
namespace WPMailSMTP\Vendor\Google\Service\Gmail\Resource;

use WPMailSMTP\Vendor\Google\Service\Gmail\ListSendAsResponse;
use WPMailSMTP\Vendor\Google\Service\Gmail\SendAs;
/**
 * The "sendAs" collection of methods.
 * Typical usage is:
 *  <code>
 *   $gmailService = new Google\Service\Gmail(...);
 *   $sendAs = $gmailService->users_settings_sendAs;
 *  </code>
 */
class UsersSettingsSendAs extends \WPMailSMTP\Vendor\Google\Service\Resource
{
    /**
     * Creates a custom "from" send-as alias. If an SMTP MSA is specified, Gmail
     * will attempt to connect to the SMTP service to validate the configuration
     * before creating the alias. If ownership verification is required for the
     * alias, a message will be sent to the email address and the resource's
     * verification status will be set to `pending`; otherwise, the resource will be
     * created with verification status set to `accepted`. If a signature is
     * provided, Gmail will sanitize the HTML before saving it with the alias. This
     * method is only available to service account clients that have been delegated
     * domain-wide authority. (sendAs.create)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param SendAs $postBody
     * @param array $optParams Optional parameters.
     * @return SendAs
     * @throws \Google\Service\Exception
     */
    public function create($userId, SendAs $postBody, $optParams = [])
    {
        $params = ['userId' => $userId, 'postBody' => $postBody];
        $params = \array_merge($params, $optParams);
        return $this->call('create', [$params], SendAs::class);
    }
    /**
     * Deletes the specified send-as alias. Revokes any verification that may have
     * been required for using it. This method is only available to service account
     * clients that have been delegated domain-wide authority. (sendAs.delete)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param string $sendAsEmail The send-as alias to be deleted.
     * @param array $optParams Optional parameters.
     * @throws \Google\Service\Exception
     */
    public function delete($userId, $sendAsEmail, $optParams = [])
    {
        $params = ['userId' => $userId, 'sendAsEmail' => $sendAsEmail];
        $params = \array_merge($params, $optParams);
        return $this->call('delete', [$params]);
    }
    /**
     * Gets the specified send-as alias. Fails with an HTTP 404 error if the
     * specified address is not a member of the collection. (sendAs.get)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param string $sendAsEmail The send-as alias to be retrieved.
     * @param array $optParams Optional parameters.
     * @return SendAs
     * @throws \Google\Service\Exception
     */
    public function get($userId, $sendAsEmail, $optParams = [])
    {
        $params = ['userId' => $userId, 'sendAsEmail' => $sendAsEmail];
        $params = \array_merge($params, $optParams);
        return $this->call('get', [$params], SendAs::class);
    }
    /**
     * Lists the send-as aliases for the specified account. The result includes the
     * primary send-as address associated with the account as well as any custom
     * "from" aliases. (sendAs.listUsersSettingsSendAs)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param array $optParams Optional parameters.
     * @return ListSendAsResponse
     * @throws \Google\Service\Exception
     */
    public function listUsersSettingsSendAs($userId, $optParams = [])
    {
        $params = ['userId' => $userId];
        $params = \array_merge($params, $optParams);
        return $this->call('list', [$params], ListSendAsResponse::class);
    }
    /**
     * Patch the specified send-as alias. (sendAs.patch)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param string $sendAsEmail The send-as alias to be updated.
     * @param SendAs $postBody
     * @param array $optParams Optional parameters.
     * @return SendAs
     * @throws \Google\Service\Exception
     */
    public function patch($userId, $sendAsEmail, SendAs $postBody, $optParams = [])
    {
        $params = ['userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'postBody' => $postBody];
        $params = \array_merge($params, $optParams);
        return $this->call('patch', [$params], SendAs::class);
    }
    /**
     * Updates a send-as alias. If a signature is provided, Gmail will sanitize the
     * HTML before saving it with the alias. Addresses other than the primary
     * address for the account can only be updated by service account clients that
     * have been delegated domain-wide authority. (sendAs.update)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param string $sendAsEmail The send-as alias to be updated.
     * @param SendAs $postBody
     * @param array $optParams Optional parameters.
     * @return SendAs
     * @throws \Google\Service\Exception
     */
    public function update($userId, $sendAsEmail, SendAs $postBody, $optParams = [])
    {
        $params = ['userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'postBody' => $postBody];
        $params = \array_merge($params, $optParams);
        return $this->call('update', [$params], SendAs::class);
    }
    /**
     * Sends a verification email to the specified send-as alias address. The
     * verification status must be `pending`. This method is only available to
     * service account clients that have been delegated domain-wide authority.
     * (sendAs.verify)
     *
     * @param string $userId User's email address. The special value "me" can be
     * used to indicate the authenticated user.
     * @param string $sendAsEmail The send-as alias to be verified.
     * @param array $optParams Optional parameters.
     * @throws \Google\Service\Exception
     */
    public function verify($userId, $sendAsEmail, $optParams = [])
    {
        $params = ['userId' => $userId, 'sendAsEmail' => $sendAsEmail];
        $params = \array_merge($params, $optParams);
        return $this->call('verify', [$params]);
    }
}
// Adding a class alias for backwards compatibility with the previous class name.
\class_alias(UsersSettingsSendAs::class, 'WPMailSMTP\\Vendor\\Google_Service_Gmail_Resource_UsersSettingsSendAs');
