1.1. Create a Google Cloud Console Project

• Visit the Google Cloud Console https://console.cloud.google.com/
• Click Create Project or select an existing project
• Enter a project name (e.g., "Odoo YouTube Integration")
• Select your organization if applicable
• Click Create

1.2. Enable YouTube Data API v3

• In your Google Cloud Console project, go to APIs & Services → Library
• Search for "YouTube Data API v3"
• Click on the API and then click Enable
• Wait for the API to be enabled (this may take a few minutes)

1.3. Create OAuth 2.0 Credentials

• Go to APIs & Services → Credentials
• Click Create Credentials → OAuth client ID

• If prompted, configure the OAuth consent screen first:

  • Choose External user type (for most cases)

  • Fill in the required app information:

    • App name: Choose a descriptive name (e.g., "Odoo YouTube Integration")
    • User support email: Your email address
    • Developer contact information: Your email address

  • Add scopes: https://www.googleapis.com/auth/youtube, https://www.googleapis.com/auth/youtube.upload, https://www.googleapis.com/auth/youtube.readonly
  • Add test users if your app is in testing mode

• After configuring the consent screen, create the OAuth client ID:

  • Application type: Web application
  • Name: Choose a descriptive name
  • Authorized redirect URIs: https://{your-odoo-instance}/social_youtube/authentication
  • Replace {your-odoo-instance} with your actual Odoo domain

• Click Create
• Download the JSON file or copy the Client ID and Client Secret

2.1. Install Module

• Go to Apps in your Odoo Community instance
• Search for "d_social_youtube"
• Click Install
• Note: This module is designed for Odoo Community Edition and requires the d_social module

2.2. Configure YouTube API Credentials

• Obtain Client ID and Client Secret from your Google Cloud Console OAuth credentials
• Go to Settings → General Settings
• Scroll to the "YouTube Integration" section

• Enter your YouTube app credentials:

  • YouTube OAuth Client ID
  • YouTube OAuth Client Secret

• Click Save

3.1. Connecting YouTube Channel

• Go to Social Marketing → Configuration → Social Media
• Find "YouTube" and click "Link Account"
• A popup window will appear asking you to authorize Odoo to access your YouTube account
• Log in to your Google account if prompted
• Grant the requested permissions (YouTube access, upload, and read permissions)
• Select the YouTube channel you want to connect (if you have multiple channels)
• After successful authorization, you'll be redirected back to Odoo
• Your YouTube channel is now connected and appears in Social Accounts

3.2. Managing YouTube Comments and Replies

• Go to Social Marketing → Posts → Live Posts
• You'll see your YouTube videos automatically synchronized
• Click on any video to view comments and engagement
• For each comment, you have several actions available:

Viewing Comments:

• Comments appear chronologically under each video
• You can see the commenter's name, profile picture, comment text, and timestamp
• The number of likes on each comment is displayed
• Nested replies are shown under parent comments

Replying to Comments:

• Click the "Reply" button under any comment
• A text box appears where you can type your response
• Click "Post" to publish your reply
• Your reply will appear nested under the original comment

Comment Pagination:

• For videos with many comments, use "Load More" to fetch additional comments
• Comments are loaded in batches for better performance

3.3. Uploading YouTube Videos

You can upload videos directly to YouTube from Odoo Community.

• Go to Social Marketing → Posts
• Click "Create" to start a new post
• Select your YouTube channel account
• Configure your video upload:

Video Upload Configuration:

• Upload Video: Click "Add file" to upload your video file

  • Supported formats: MP4, MOV, AVI, WMV, FLV, WebM
  • Maximum file size: 256GB
  • Recommended: MP4 format with H.264 video codec

• Video Title: Enter your video title (max 100 characters)
• Description: Write your video description (max 5000 characters)
• Category: Select the appropriate YouTube category

• Privacy Settings: Choose video visibility:

  • Public: Anyone can search for and view
  • Unlisted: Anyone with the link can view
  • Private: Only you can view

• Language: Set the primary language of your video
• Tags: Add relevant tags to help with discoverability
• Made for Kids: Check if your content is made for children (COPPA compliance)
• Notify Subscribers: Choose whether to notify your subscribers about the new video

Upload Process:

1. When you click "Post", Odoo uploads your video to YouTube's servers
2. YouTube processes the video (transcoding, validation)
3. The upload uses resumable upload protocol for large files
4. Progress is tracked and displayed in Odoo
5. Once published, the video appears in your YouTube channel and in Odoo live posts

3.4. Video Analytics and Performance Tracking

Access comprehensive analytics for your YouTube channel performance:

• Video Performance: Views, likes, comments, dislikes, and favorites
• Channel Statistics: Subscriber count, total views, video count
• Engagement Metrics: Like-to-view ratio, comment engagement
• Video Details: Duration, category, language, publication date
• Thumbnail Management: Automatic thumbnail download and display

Synchronization Features:

• Automatic video synchronization from your YouTube channel
• Real-time statistics updates
• Thumbnail and metadata synchronization
• Upload playlist monitoring for new content detection

3.5. Video Management and Updates

You can update video metadata directly from Odoo:

• Update Video Information: Modify title, description, tags, and privacy settings
• Category Changes: Update video category as needed
• Privacy Management: Change video visibility settings
• Tag Management: Add or remove tags for better discoverability

Bulk Operations:

• Sync multiple videos at once
• Batch update video metadata
• Mass privacy setting changes

4.1. Integration with d_social Framework

This module is built specifically for Odoo Community Edition and integrates seamlessly with the d_social framework:

• Unified Interface: All social media management in one place
• Consistent Experience: Same UI patterns as other social media modules
• Extensible: Easy to extend with custom features
• Community Support: Built by and for the Community Edition users

4.2. Advanced Video Preview

• Dynamic Preview: See how your video will appear on YouTube before publishing
• Embed Support: Generate embed codes for your videos
• Thumbnail Preview: View video thumbnails and metadata
• Responsive Design: Preview adapts to different screen sizes

4.3. Resumable Upload Technology

• Large File Support: Upload videos up to 256GB
• Retry Logic: Automatic retry for failed uploads
• Progress Tracking: Real-time upload progress monitoring
• Chunk-based Upload: Efficient handling of large video files

Common Issues:

• Authentication Failed: Verify your Client ID and Secret in Settings
• Scope Error: Ensure all required scopes are enabled in your Google Cloud Console
• Upload Failed: Check file format and size limits (videos: max 256GB, supported formats: MP4, MOV, AVI, etc.)
• Callback URL Error: Verify the OAuth callback URL matches your Odoo domain
• API Quota Exceeded: Check your YouTube API quota in Google Cloud Console
• Channel Not Found: Ensure you have a YouTube channel associated with your Google account
• Permission Denied: Verify you have granted all required permissions during OAuth flow

Video Upload Issues:

• File Too Large: Use video compression or split large files
• Unsupported Format: Convert to MP4 with H.264 codec
• Network Timeout: Check your internet connection and try again
• Processing Failed: YouTube may reject videos that violate community guidelines

Module Dependencies:

• Ensure d_social module is installed and configured
• Check that all required Python libraries are available
• Verify your Odoo instance has internet access for API calls

For additional support: * Email: duongodooapps@gmail.com * Website: https://duong-odoo-apps.odoo.com * Check YouTube's Data API Documentation https://developers.google.com/youtube/v3

11.1. Custom Video Categories

YouTube supports various video categories. The module includes the most common ones:

• Film & Animation
• Autos & Vehicles
• Music
• Pets & Animals
• Sports
• Travel & Events
• Gaming
• People & Blogs
• Comedy
• Entertainment
• News & Politics
• Howto & Style
• Education
• Science & Technology
• Nonprofits & Activism

11.2. Language and Localization

• Set default language for your videos
• Support for multiple languages in video metadata
• Localized category names and descriptions
• Regional content targeting options

11.3. Webhook Integration (Future Enhancement)

While not currently implemented, future versions may include:

• Real-time comment notifications
• Video processing status updates
• Channel statistics webhooks
• Subscriber count updates

12.1. Data Backup

• Regular backup of your Odoo database includes all YouTube integration data
• Video files are stored on YouTube's servers, not in Odoo
• Metadata and analytics data are stored in Odoo database
• OAuth tokens are encrypted and stored securely

12.2. Module Updates

• Always backup your database before updating the module
• Review changelog for breaking changes
• Test updates in a staging environment first
• Re-authorize accounts if OAuth scopes change

13.1. Data Privacy

• The module only accesses YouTube data you explicitly authorize
• No personal data is shared with third parties
• All API communications are encrypted
• User consent is required for OAuth authorization

13.2. Terms of Service

• Usage subject to YouTube Terms of Service
• Google Cloud Platform Terms of Service apply
• Odoo Community Edition license terms
• Module-specific terms and conditions

This comprehensive guide should help you successfully set up and use YouTube integration with your Odoo Community Edition instance. For any additional questions or support, please don't hesitate to contact our support team.