Initial commit

google-client/vendor/google/apiclient-services/src/StreetViewPublish/Resource/Photo.php

@@ -0,0 +1,164 @@
+<?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 Google\Service\StreetViewPublish\Resource;
+
+use Google\Service\StreetViewPublish\Photo as PhotoModel;
+use Google\Service\StreetViewPublish\StreetviewpublishEmpty;
+use Google\Service\StreetViewPublish\UploadRef;
+
+/**
+ * The "photo" collection of methods.
+ * Typical usage is:
+ *  <code>
+ *   $streetviewpublishService = new Google\Service\StreetViewPublish(...);
+ *   $photo = $streetviewpublishService->photo;
+ *  </code>
+ */
+class Photo extends \Google\Service\Resource
+{
+  /**
+   * After the client finishes uploading the photo with the returned UploadRef,
+   * CreatePhoto publishes the uploaded Photo to Street View on Google Maps.
+   * Currently, the only way to set heading, pitch, and roll in CreatePhoto is
+   * through the [Photo Sphere XMP
+   * metadata](https://developers.google.com/streetview/spherical-metadata) in the
+   * photo bytes. CreatePhoto ignores the `pose.heading`, `pose.pitch`,
+   * `pose.roll`, `pose.altitude`, and `pose.level` fields in Pose. This method
+   * returns the following error codes: * google.rpc.Code.INVALID_ARGUMENT if the
+   * request is malformed or if the uploaded photo is not a 360 photo. *
+   * google.rpc.Code.NOT_FOUND if the upload reference does not exist. *
+   * google.rpc.Code.RESOURCE_EXHAUSTED if the account has reached the storage
+   * limit. (photo.create)
+   *
+   * @param PhotoModel $postBody
+   * @param array $optParams Optional parameters.
+   * @return PhotoModel
+   * @throws \Google\Service\Exception
+   */
+  public function create(PhotoModel $postBody, $optParams = [])
+  {
+    $params = ['postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('create', [$params], PhotoModel::class);
+  }
+  /**
+   * Deletes a Photo and its metadata. This method returns the following error
+   * codes: * google.rpc.Code.PERMISSION_DENIED if the requesting user did not
+   * create the requested photo. * google.rpc.Code.NOT_FOUND if the photo ID does
+   * not exist. (photo.delete)
+   *
+   * @param string $photoId Required. ID of the Photo.
+   * @param array $optParams Optional parameters.
+   * @return StreetviewpublishEmpty
+   * @throws \Google\Service\Exception
+   */
+  public function delete($photoId, $optParams = [])
+  {
+    $params = ['photoId' => $photoId];
+    $params = array_merge($params, $optParams);
+    return $this->call('delete', [$params], StreetviewpublishEmpty::class);
+  }
+  /**
+   * Gets the metadata of the specified Photo. This method returns the following
+   * error codes: * google.rpc.Code.PERMISSION_DENIED if the requesting user did
+   * not create the requested Photo. * google.rpc.Code.NOT_FOUND if the requested
+   * Photo does not exist. * google.rpc.Code.UNAVAILABLE if the requested Photo is
+   * still being indexed. (photo.get)
+   *
+   * @param string $photoId Required. ID of the Photo.
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string languageCode The BCP-47 language code, such as "en-US" or
+   * "sr-Latn". For more information, see
+   * http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. If
+   * language_code is unspecified, the user's language preference for Google
+   * services is used.
+   * @opt_param string view Required. Specifies if a download URL for the photo
+   * bytes should be returned in the Photo response.
+   * @return PhotoModel
+   * @throws \Google\Service\Exception
+   */
+  public function get($photoId, $optParams = [])
+  {
+    $params = ['photoId' => $photoId];
+    $params = array_merge($params, $optParams);
+    return $this->call('get', [$params], PhotoModel::class);
+  }
+  /**
+   * Creates an upload session to start uploading photo bytes. The method uses the
+   * upload URL of the returned UploadRef to upload the bytes for the Photo. In
+   * addition to the photo requirements shown in
+   * https://support.google.com/maps/answer/7012050?ref_topic=6275604, the photo
+   * must meet the following requirements: * Photo Sphere XMP metadata must be
+   * included in the photo metadata. See
+   * https://developers.google.com/streetview/spherical-metadata for the required
+   * fields. * The pixel size of the photo must meet the size requirements listed
+   * in https://support.google.com/maps/answer/7012050?ref_topic=6275604, and the
+   * photo must be a full 360 horizontally. After the upload completes, the method
+   * uses UploadRef with CreatePhoto to create the Photo object entry.
+   * (photo.startUpload)
+   *
+   * @param StreetviewpublishEmpty $postBody
+   * @param array $optParams Optional parameters.
+   * @return UploadRef
+   * @throws \Google\Service\Exception
+   */
+  public function startUpload(StreetviewpublishEmpty $postBody, $optParams = [])
+  {
+    $params = ['postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('startUpload', [$params], UploadRef::class);
+  }
+  /**
+   * Updates the metadata of a Photo, such as pose, place association,
+   * connections, etc. Changing the pixels of a photo is not supported. Only the
+   * fields specified in the updateMask field are used. If `updateMask` is not
+   * present, the update applies to all fields. This method returns the following
+   * error codes: * google.rpc.Code.PERMISSION_DENIED if the requesting user did
+   * not create the requested photo. * google.rpc.Code.INVALID_ARGUMENT if the
+   * request is malformed. * google.rpc.Code.NOT_FOUND if the requested photo does
+   * not exist. * google.rpc.Code.UNAVAILABLE if the requested Photo is still
+   * being indexed. (photo.update)
+   *
+   * @param string $id A unique identifier for a photo.
+   * @param PhotoModel $postBody
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string updateMask Required. Mask that identifies fields on the
+   * photo metadata to update. If not present, the old Photo metadata is entirely
+   * replaced with the new Photo metadata in this request. The update fails if
+   * invalid fields are specified. Multiple fields can be specified in a comma-
+   * delimited list. The following fields are valid: * `pose.heading` *
+   * `pose.lat_lng_pair` * `pose.pitch` * `pose.roll` * `pose.level` *
+   * `pose.altitude` * `connections` * `places` > Note: When updateMask contains
+   * repeated fields, the entire set of repeated values get replaced with the new
+   * contents. For example, if updateMask contains `connections` and
+   * `UpdatePhotoRequest.photo.connections` is empty, all connections are removed.
+   * @return PhotoModel
+   * @throws \Google\Service\Exception
+   */
+  public function update($id, PhotoModel $postBody, $optParams = [])
+  {
+    $params = ['id' => $id, 'postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('update', [$params], PhotoModel::class);
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(Photo::class, 'Google_Service_StreetViewPublish_Resource_Photo');

google-client/vendor/google/apiclient-services/src/StreetViewPublish/Resource/PhotoSequence.php

@@ -0,0 +1,127 @@
+<?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 Google\Service\StreetViewPublish\Resource;
+
+use Google\Service\StreetViewPublish\Operation;
+use Google\Service\StreetViewPublish\PhotoSequence as PhotoSequenceModel;
+use Google\Service\StreetViewPublish\StreetviewpublishEmpty;
+use Google\Service\StreetViewPublish\UploadRef;
+
+/**
+ * The "photoSequence" collection of methods.
+ * Typical usage is:
+ *  <code>
+ *   $streetviewpublishService = new Google\Service\StreetViewPublish(...);
+ *   $photoSequence = $streetviewpublishService->photoSequence;
+ *  </code>
+ */
+class PhotoSequence extends \Google\Service\Resource
+{
+  /**
+   * After the client finishes uploading the PhotoSequence with the returned
+   * UploadRef, CreatePhotoSequence extracts a sequence of 360 photos from a video
+   * or Extensible Device Metadata (XDM, http://www.xdm.org/) to be published to
+   * Street View on Google Maps. `CreatePhotoSequence` returns an Operation, with
+   * the PhotoSequence Id set in the `Operation.name` field. This method returns
+   * the following error codes: * google.rpc.Code.INVALID_ARGUMENT if the request
+   * is malformed. * google.rpc.Code.NOT_FOUND if the upload reference does not
+   * exist. (photoSequence.create)
+   *
+   * @param PhotoSequenceModel $postBody
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string inputType Required. The input form of PhotoSequence.
+   * @return Operation
+   * @throws \Google\Service\Exception
+   */
+  public function create(PhotoSequenceModel $postBody, $optParams = [])
+  {
+    $params = ['postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('create', [$params], Operation::class);
+  }
+  /**
+   * Deletes a PhotoSequence and its metadata. This method returns the following
+   * error codes: * google.rpc.Code.PERMISSION_DENIED if the requesting user did
+   * not create the requested photo sequence. * google.rpc.Code.NOT_FOUND if the
+   * photo sequence ID does not exist. * google.rpc.Code.FAILED_PRECONDITION if
+   * the photo sequence ID is not yet finished processing. (photoSequence.delete)
+   *
+   * @param string $sequenceId Required. ID of the PhotoSequence.
+   * @param array $optParams Optional parameters.
+   * @return StreetviewpublishEmpty
+   * @throws \Google\Service\Exception
+   */
+  public function delete($sequenceId, $optParams = [])
+  {
+    $params = ['sequenceId' => $sequenceId];
+    $params = array_merge($params, $optParams);
+    return $this->call('delete', [$params], StreetviewpublishEmpty::class);
+  }
+  /**
+   * Gets the metadata of the specified PhotoSequence via the Operation interface.
+   * This method returns the following three types of responses: *
+   * `Operation.done` = false, if the processing of PhotoSequence is not finished
+   * yet. * `Operation.done` = true and `Operation.error` is populated, if there
+   * was an error in processing. * `Operation.done` = true and
+   * `Operation.response` is poulated, which contains a PhotoSequence message.
+   * This method returns the following error codes: *
+   * google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the
+   * requested PhotoSequence. * google.rpc.Code.NOT_FOUND if the requested
+   * PhotoSequence does not exist. (photoSequence.get)
+   *
+   * @param string $sequenceId Required. ID of the photo sequence.
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string filter Optional. The filter expression. For example:
+   * `published_status=PUBLISHED`. The filters supported are: `published_status`.
+   * See https://google.aip.dev/160 for more information.
+   * @opt_param string view Specifies if a download URL for the photo sequence
+   * should be returned in `download_url` of individual photos in the
+   * PhotoSequence response. > Note: Currently not implemented.
+   * @return Operation
+   * @throws \Google\Service\Exception
+   */
+  public function get($sequenceId, $optParams = [])
+  {
+    $params = ['sequenceId' => $sequenceId];
+    $params = array_merge($params, $optParams);
+    return $this->call('get', [$params], Operation::class);
+  }
+  /**
+   * Creates an upload session to start uploading photo sequence data. The upload
+   * URL of the returned UploadRef is used to upload the data for the
+   * `photoSequence`. After the upload is complete, the UploadRef is used with
+   * CreatePhotoSequence to create the PhotoSequence object entry.
+   * (photoSequence.startUpload)
+   *
+   * @param StreetviewpublishEmpty $postBody
+   * @param array $optParams Optional parameters.
+   * @return UploadRef
+   * @throws \Google\Service\Exception
+   */
+  public function startUpload(StreetviewpublishEmpty $postBody, $optParams = [])
+  {
+    $params = ['postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('startUpload', [$params], UploadRef::class);
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(PhotoSequence::class, 'Google_Service_StreetViewPublish_Resource_PhotoSequence');

google-client/vendor/google/apiclient-services/src/StreetViewPublish/Resource/PhotoSequences.php

@@ -0,0 +1,65 @@
+<?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 Google\Service\StreetViewPublish\Resource;
+
+use Google\Service\StreetViewPublish\ListPhotoSequencesResponse;
+
+/**
+ * The "photoSequences" collection of methods.
+ * Typical usage is:
+ *  <code>
+ *   $streetviewpublishService = new Google\Service\StreetViewPublish(...);
+ *   $photoSequences = $streetviewpublishService->photoSequences;
+ *  </code>
+ */
+class PhotoSequences extends \Google\Service\Resource
+{
+  /**
+   * Lists all the PhotoSequences that belong to the user, in descending
+   * CreatePhotoSequence timestamp order. (photoSequences.listPhotoSequences)
+   *
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string filter Optional. The filter expression. For example:
+   * `imagery_type=SPHERICAL`. The filters supported are: `imagery_type`,
+   * `processing_state`, `min_latitude`, `max_latitude`, `min_longitude`,
+   * `max_longitude`, `filename_query`, `min_capture_time_seconds`,
+   * `max_capture_time_seconds. See https://google.aip.dev/160 for more
+   * information. Filename queries should sent as a Phrase in order to support
+   * multiple words and special characters by adding escaped quotes. Ex:
+   * filename_query="example of a phrase.mp4"
+   * @opt_param int pageSize Optional. The maximum number of photo sequences to
+   * return. `pageSize` must be non-negative. If `pageSize` is zero or is not
+   * provided, the default page size of 100 is used. The number of photo sequences
+   * returned in the response may be less than `pageSize` if the number of matches
+   * is less than `pageSize`. This is currently unimplemented but is in process.
+   * @opt_param string pageToken Optional. The nextPageToken value returned from a
+   * previous ListPhotoSequences request, if any.
+   * @return ListPhotoSequencesResponse
+   * @throws \Google\Service\Exception
+   */
+  public function listPhotoSequences($optParams = [])
+  {
+    $params = [];
+    $params = array_merge($params, $optParams);
+    return $this->call('list', [$params], ListPhotoSequencesResponse::class);
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(PhotoSequences::class, 'Google_Service_StreetViewPublish_Resource_PhotoSequences');

google-client/vendor/google/apiclient-services/src/StreetViewPublish/Resource/Photos.php

@@ -0,0 +1,145 @@
+<?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 Google\Service\StreetViewPublish\Resource;
+
+use Google\Service\StreetViewPublish\BatchDeletePhotosRequest;
+use Google\Service\StreetViewPublish\BatchDeletePhotosResponse;
+use Google\Service\StreetViewPublish\BatchGetPhotosResponse;
+use Google\Service\StreetViewPublish\BatchUpdatePhotosRequest;
+use Google\Service\StreetViewPublish\BatchUpdatePhotosResponse;
+use Google\Service\StreetViewPublish\ListPhotosResponse;
+
+/**
+ * The "photos" collection of methods.
+ * Typical usage is:
+ *  <code>
+ *   $streetviewpublishService = new Google\Service\StreetViewPublish(...);
+ *   $photos = $streetviewpublishService->photos;
+ *  </code>
+ */
+class Photos extends \Google\Service\Resource
+{
+  /**
+   * Deletes a list of Photos and their metadata. Note that if BatchDeletePhotos
+   * fails, either critical fields are missing or there is an authentication
+   * error. Even if BatchDeletePhotos succeeds, individual photos in the batch may
+   * have failures. These failures are specified in each PhotoResponse.status in
+   * BatchDeletePhotosResponse.results. See DeletePhoto for specific failures that
+   * can occur per photo. (photos.batchDelete)
+   *
+   * @param BatchDeletePhotosRequest $postBody
+   * @param array $optParams Optional parameters.
+   * @return BatchDeletePhotosResponse
+   * @throws \Google\Service\Exception
+   */
+  public function batchDelete(BatchDeletePhotosRequest $postBody, $optParams = [])
+  {
+    $params = ['postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('batchDelete', [$params], BatchDeletePhotosResponse::class);
+  }
+  /**
+   * Gets the metadata of the specified Photo batch. Note that if BatchGetPhotos
+   * fails, either critical fields are missing or there is an authentication
+   * error. Even if BatchGetPhotos succeeds, individual photos in the batch may
+   * have failures. These failures are specified in each PhotoResponse.status in
+   * BatchGetPhotosResponse.results. See GetPhoto for specific failures that can
+   * occur per photo. (photos.batchGet)
+   *
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string languageCode Optional. The BCP-47 language code, such as
+   * "en-US" or "sr-Latn". For more information, see
+   * http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. If
+   * language_code is unspecified, the user's language preference for Google
+   * services is used.
+   * @opt_param string photoIds
+   * @opt_param string view Required. Specifies if a download URL for the photo
+   * bytes should be returned in the Photo response.
+   * @return BatchGetPhotosResponse
+   * @throws \Google\Service\Exception
+   */
+  public function batchGet($optParams = [])
+  {
+    $params = [];
+    $params = array_merge($params, $optParams);
+    return $this->call('batchGet', [$params], BatchGetPhotosResponse::class);
+  }
+  /**
+   * Updates the metadata of Photos, such as pose, place association, connections,
+   * etc. Changing the pixels of photos is not supported. Note that if
+   * BatchUpdatePhotos fails, either critical fields are missing or there is an
+   * authentication error. Even if BatchUpdatePhotos succeeds, individual photos
+   * in the batch may have failures. These failures are specified in each
+   * PhotoResponse.status in BatchUpdatePhotosResponse.results. See UpdatePhoto
+   * for specific failures that can occur per photo. Only the fields specified in
+   * updateMask field are used. If `updateMask` is not present, the update applies
+   * to all fields. The number of UpdatePhotoRequest messages in a
+   * BatchUpdatePhotosRequest must not exceed 20. > Note: To update Pose.altitude,
+   * Pose.latLngPair has to be filled as well. Otherwise, the request will fail.
+   * (photos.batchUpdate)
+   *
+   * @param BatchUpdatePhotosRequest $postBody
+   * @param array $optParams Optional parameters.
+   * @return BatchUpdatePhotosResponse
+   * @throws \Google\Service\Exception
+   */
+  public function batchUpdate(BatchUpdatePhotosRequest $postBody, $optParams = [])
+  {
+    $params = ['postBody' => $postBody];
+    $params = array_merge($params, $optParams);
+    return $this->call('batchUpdate', [$params], BatchUpdatePhotosResponse::class);
+  }
+  /**
+   * Lists all the Photos that belong to the user. > Note: Recently created photos
+   * that are still being indexed are not returned in the response.
+   * (photos.listPhotos)
+   *
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param string filter Optional. The filter expression. For example:
+   * `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters supported are: `placeId`,
+   * `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`. See
+   * https://google.aip.dev/160 for more information.
+   * @opt_param string languageCode Optional. The BCP-47 language code, such as
+   * "en-US" or "sr-Latn". For more information, see
+   * http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. If
+   * language_code is unspecified, the user's language preference for Google
+   * services is used.
+   * @opt_param int pageSize Optional. The maximum number of photos to return.
+   * `pageSize` must be non-negative. If `pageSize` is zero or is not provided,
+   * the default page size of 100 is used. The number of photos returned in the
+   * response may be less than `pageSize` if the number of photos that belong to
+   * the user is less than `pageSize`.
+   * @opt_param string pageToken Optional. The nextPageToken value returned from a
+   * previous ListPhotos request, if any.
+   * @opt_param string view Required. Specifies if a download URL for the photos
+   * bytes should be returned in the Photos response.
+   * @return ListPhotosResponse
+   * @throws \Google\Service\Exception
+   */
+  public function listPhotos($optParams = [])
+  {
+    $params = [];
+    $params = array_merge($params, $optParams);
+    return $this->call('list', [$params], ListPhotosResponse::class);
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(Photos::class, 'Google_Service_StreetViewPublish_Resource_Photos');