[ADD] product_images: add a tutorial

This will help users to get automatically images for thier products.

task-2558054

Author: chevalierv

content/applications/general.rst

@@ -13,3 +13,4 @@ Miscellaneous
     general/calendars
     general/in_app_purchase
     general/developer_mode
+    general/product_images

content/applications/general/product_images.rst

@@ -0,0 +1,133 @@
+==============
+Product images
+==============
+
+The product images are very useful in Odoo, for example, to quickly find a product or check if you 
+scanned the right one, but it can be a bit painful to set up especially if you have a lot of 
+products. **Google Custom Search** allows finding images automatically for your product, based on 
+their barcode, keeping your focus on what matters in your business.
+
+.. _product_images/configuration:
+
+Configuration
+=============
+
+This functionnality requires configuration both on Google and on Odoo.
+
+With a free Google account, you can get up to 100 free images per day. If you need more images, 
+you'll have to upgrade to a billing account.
+
+.. _product_images/google-api-dashboard:
+
+Google API dashboard
+--------------------
+
+#. Go to `Google Cloud Platform API & Services <https://console.developers.google.com/>`__ page
+   to generate Google Custom Search API credentials. Log in with your Google account.
+
+#. Select or create an API project to store the credentials if not yet done before. Give it an 
+   explicit name (e.g. Odoo Images).
+
+#. In the credentials section, click on `Create Crendentials` and select `API Keys`.
+
+   .. image:: product_images/google-images-credentials00.png
+      :align: center
+
+#. Save it, you'll need it for the next step in Odoo !
+
+#. Use the search bar to find for `Google Custom Search API` and select it.
+
+   .. image:: product_images/google-images-credentials01.png
+      :align: center
+
+#. Enable the API.
+
+   .. image:: product_images/google-images-credentials02.png
+      :align: center
+
+.. _product_images/google-pse-dashboard:
+
+Google Programmable Search dashboard
+------------------------------------
+
+#. Go to `Google Programmable Search Engine <https://programmablesearchengine.google.com/>`__ and
+   click on `Get Started`. Log in with your Google account.
+
+   .. image:: product_images/google-images-credentials03.png
+      :align: center
+
+#. Fill the language and the name of the search engine. Give it an explicit name
+   (e.g. Odoo Images).
+
+   .. note::
+      Google doesn't allow to create a search engine without having entered at least one specific
+      site to search on. You can put any website (e.g. www.google.com) for this step, we will
+      remove it later.
+
+#. Validate the form by clicking on `Create`. Then, go to the edition mode of the search engine
+   that you created (either by clicking on `Control Panel` on the confirmation page or by
+   clicking on the name of your Search Engine on the Home page).
+
+#. In the basics tab, make sure to enable Image search, SafeSearch and Search the entire web.
+
+   .. note::
+      Once `Search the entire web` enabled, you can safely delete the site that you previously
+      entered at the previous step.
+
+#. Save your **Search Engine Id**.
+
+   .. tip::
+      You can easily save your Search Engine ID by clicking on the Copy to clipboard button next to
+      it.
+
+.. _product_images/setup-in-odoo:
+
+Odoo
+----
+
+#. Go to :menuselection:`Settings --> General Settings --> Integrations`,
+   activate **Google Images** and save.
+
+#. Go back to :menuselection:`Settings --> General Settings`, enter your **API Key** and
+   **Search Engine ID** in Google Images settings and save again.
+
+#. The setup is now ready.
+
+.. _product_images/get-product-images:
+
+Automatically get your product images in Odoo
+=============================================
+
+The action to automatically get your product images in Odoo appears in any Products or Product
+Variants list view. Here is a step-by-step guide from the Inventory app.
+
+#. Go to :menuselection:`Inventory --> Products --> Products` or :menuselection:`Inventory -->
+   Products --> Product Variants`.
+
+#. On the list view, select the products that needs an image.
+
+   .. important::
+      Only the 10K first products or product variants selected will be processed.
+
+   .. note::
+      Only the products or product variants with a barcode and without an image will be processed.
+      If you select a product that has one or more variants from the Products view, each variant
+      matching the previous criteria will be processed.
+
+#. In the action menu, select `Get Pictures from Google Images` and validate by clicking on 
+   `Get picture`.
+
+#. You should see your images appearing incrementally.
+
+   .. note::
+      Only the 10 first images are fetched immediatly. If you selected more than 10, the rest will
+      be fetched as a background job, so you can continue doing your work while illustrating your
+      products.
+
+      The background job process about 100 images in a minute. If you reach the quota authorized
+      by Google (either with a free or a paid plan), the background job will put itself on hold
+      for 24 hours and continue right where he stopped the day before. 
+
+.. seealso::
+   - `Create, modify, or close your Google Cloud Billing account
+     <https://cloud.google.com/billing/docs/how-to/manage-billing-account>`_