ThirdParty Api Signins

Edit: 1/6/23

Note that the use of the desktop launcher is deprecated. I'm leaving the instructions there for future use, but if you are reading this from the quest 2 headset, then realize you have to manually input the api keys. Here is the video link from within the game on how to do it. Again much apologies as this is the only way to make this work temporarily. I'm working on a future update where you don't need to input any apis. It'll just work out of the box on a future patch. We have to deal with this for now. Sorry :(

So why all of this setup? This is the only way to allow you to have more searches. Majority of the gamers in this world will probably use the default set aka not sign in. webSurf has its own developer account but has its own limits too for the number of searches it can run. If you want more searches, you'd need to make your own account (as described below) so you get your own search quota instead of relying on the webSurf developer limits. It is just programmer stuff that is unavoidable.

If this is your first time doing this, do both youtube and giphy at the same time. This will just avoid headache in the future. It is programmed in the game world of the menu that you input both api keys for this to work. This shouldn't take more than a few minutes. Of course time permitting, I'll figure out a better api flow or to not have this needed at all. For now, we'll just work with what we go. When life gives you lemons.....

Sorry for the mess! Busy coding and burning my candle on both ends... :(

Trust me. It'll be a lot easier there than doing this on the headset cause you have to click around a lot to get the apis.

1.) I know this is a pain, but make sure to sign out from the VR menu of webSurf. I'm working on making it so you don't have to in the future. This is the quickest workaround fix to sync up Desktop to VR. DO NOT hit cloudsync in the VR menu while doing this. That is VR to Desktop.

2.) Make sure to sign-in/register at https://playwebsurf.com/ and download the desktop launcher. Open the launcher and turn on the desktop app version of webSurf. You'll input all the info. below into the menu page of the desktop version of the game (just like you see in the menu of VR). It'll just be easier to do with the keyboard/mouse and browser.

3.) Click exit in the Desktop menu. Hit escape to pull up the menu in desktop.

4.) Open up webSurf within your headset and sign back in within the VR menu. The data should pull from the servers and the apis you inputted on the desktop should show in your headset menu (to the left of your menu screen).

Again, sorry for the complications. This is the quickest fix for this for now. Working on making this simpler in future versions!

1.) If you are not signed-in already, go to google cloud platform and sign in with your google account. Create a google account if you do not already have one.

2.) You will go to the getting started page of the cloud platform if this is your first time signing in. Make sure to click on the upper left (hamburger), hover over APIs & Services and click on Credentials.

3.) If this is your first time on the developer platform then Create Project from the credentials page that you clicked on up above.

4.) Change the project name to whatever you want. In this case, I just used the example name - webSurf. Don't touch anything else. Don't mess with the project-id. Let it auto-generate it for you as to not make it any more complicated. And click the create button when you are done. You can leave it with no organization as the location.

5.) You should get a screen like below and make sure to click on the Dashboard tab (on the left window pane if you are not there already) where you can then click on Enable Apis and Services.

6.) After clicking Enable Apis and Services you should get a window, like below, where you can search for the Youtube Data APIv3. As you type into the search box it'll auto-generate options for you. Type in "youtube" into the search box to begin the process.

7.) When you fully type in the word "youtube" into the search box it should auto-generate a screen like below where you can click on the

Youtube Data API v3

8.) You should get the window pane like below. Go ahead and click enable to turn on the api.

9.) When you see this window below that means you have successfully turned on the API.

10.) Now click on the hamburger menu button in the upper left, hover over the APIs and Services and click on Credentials.

11.) You should now be on the Credentials screen. It should like the image below. Then go ahead and click on the create credentials to make a key.

12.) Make an API Key.

13.) It should generate a key and make sure to copy and paste this key into the input field of the game. Don't click restrict key. Just copy that string of characters.

Conclusion:

A.) In the event the key doesn't work, just go back to the credentials page and make a new key and input it in the game menu. Sorry for all the steps, but this is the only way to get this thing to work if you want to have more searches in the game world.

B.) Warning that if you don't use the youtube api key within 90 days consecutive, that youtube can shutdown your key. Please refer to the youtube api preservation warning guide for details. In short, try to disable youtube if you know you won't be using webSurf within 90 days.

1.) Go to the Giphy developer page and click the login button if you are not already logged in. If you need to make a new account, still click log in and click the button on the signin page to create a new account.

2.) When you login or create a new account it should autopop you up to the dashboard where you can create your app. The screen should be open like below, but if it isn't be sure to go to the dashboard tab in the navbar and click on create app. Select API and NOT the recommended SDK. Again, I repeat, click on API NOT SDK. I programmed this with api. Just do this to avoid headache.

3.) Then fill out the form of the app with whatever you want. Example here is just webSurf.

4.) Finally, copy and paste the api key into the input field of the game menu.